Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 1 | <html><body> |
| 2 | <style> |
| 3 | |
| 4 | body, h1, h2, h3, div, span, p, pre, a { |
| 5 | margin: 0; |
| 6 | padding: 0; |
| 7 | border: 0; |
| 8 | font-weight: inherit; |
| 9 | font-style: inherit; |
| 10 | font-size: 100%; |
| 11 | font-family: inherit; |
| 12 | vertical-align: baseline; |
| 13 | } |
| 14 | |
| 15 | body { |
| 16 | font-size: 13px; |
| 17 | padding: 1em; |
| 18 | } |
| 19 | |
| 20 | h1 { |
| 21 | font-size: 26px; |
| 22 | margin-bottom: 1em; |
| 23 | } |
| 24 | |
| 25 | h2 { |
| 26 | font-size: 24px; |
| 27 | margin-bottom: 1em; |
| 28 | } |
| 29 | |
| 30 | h3 { |
| 31 | font-size: 20px; |
| 32 | margin-bottom: 1em; |
| 33 | margin-top: 1em; |
| 34 | } |
| 35 | |
| 36 | pre, code { |
| 37 | line-height: 1.5; |
| 38 | font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| 39 | } |
| 40 | |
| 41 | pre { |
| 42 | margin-top: 0.5em; |
| 43 | } |
| 44 | |
| 45 | h1, h2, h3, p { |
| 46 | font-family: Arial, sans serif; |
| 47 | } |
| 48 | |
| 49 | h1, h2, h3 { |
| 50 | border-bottom: solid #CCC 1px; |
| 51 | } |
| 52 | |
| 53 | .toc_element { |
| 54 | margin-top: 0.5em; |
| 55 | } |
| 56 | |
| 57 | .firstline { |
| 58 | margin-left: 2 em; |
| 59 | } |
| 60 | |
| 61 | .method { |
| 62 | margin-top: 1em; |
| 63 | border: solid 1px #CCC; |
| 64 | padding: 1em; |
| 65 | background: #EEE; |
| 66 | } |
| 67 | |
| 68 | .details { |
| 69 | font-weight: bold; |
| 70 | font-size: 14px; |
| 71 | } |
| 72 | |
| 73 | </style> |
| 74 | |
| 75 | <h1><a href="androidpublisher_v3.html">Google Play Developer API</a> . <a href="androidpublisher_v3.edits.html">edits</a> . <a href="androidpublisher_v3.edits.tracks.html">tracks</a></h1> |
| 76 | <h2>Instance Methods</h2> |
| 77 | <p class="toc_element"> |
| 78 | <code><a href="#get">get(packageName, editId, track)</a></code></p> |
| 79 | <p class="firstline">Fetches the track configuration for the specified track type. Includes the APK version codes that are in this track.</p> |
| 80 | <p class="toc_element"> |
| 81 | <code><a href="#list">list(packageName, editId)</a></code></p> |
| 82 | <p class="firstline">Lists all the track configurations for this edit.</p> |
| 83 | <p class="toc_element"> |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 84 | <code><a href="#patch">patch(packageName, editId, track, body=None)</a></code></p> |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 85 | <p class="firstline">Updates the track configuration for the specified track type. This method supports patch semantics.</p> |
| 86 | <p class="toc_element"> |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 87 | <code><a href="#update">update(packageName, editId, track, body=None)</a></code></p> |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 88 | <p class="firstline">Updates the track configuration for the specified track type.</p> |
| 89 | <h3>Method Details</h3> |
| 90 | <div class="method"> |
| 91 | <code class="details" id="get">get(packageName, editId, track)</code> |
| 92 | <pre>Fetches the track configuration for the specified track type. Includes the APK version codes that are in this track. |
| 93 | |
| 94 | Args: |
| 95 | packageName: string, Unique identifier for the Android app that is being updated; for example, "com.spiffygame". (required) |
| 96 | editId: string, Unique identifier for this edit. (required) |
| 97 | track: string, The track to read or modify. (required) |
| 98 | |
| 99 | Returns: |
| 100 | An object of the form: |
| 101 | |
| 102 | { |
| 103 | "track": "A String", # Identifier for this track. |
| 104 | "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes. |
| 105 | { |
| 106 | "status": "A String", # The desired status of this release. |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 107 | "pinnedVersions": [ |
| 108 | { |
| 109 | "versionCodes": [ |
| 110 | "A String", |
| 111 | ], |
| 112 | "targetings": [ |
| 113 | { |
| 114 | "countryCodes": [ |
| 115 | "A String", |
| 116 | ], |
| 117 | "phoneskyVersions": [ |
| 118 | "A String", |
| 119 | ], |
| 120 | "sdkVersions": [ |
| 121 | 42, |
| 122 | ], |
| 123 | "devices": [ |
| 124 | { |
| 125 | "device": "A String", |
| 126 | "brand": "A String", |
| 127 | "product": "A String", |
| 128 | }, |
| 129 | ], |
| 130 | }, |
| 131 | ], |
| 132 | }, |
| 133 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 134 | "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs. |
| 135 | "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases. |
| 136 | "A String", |
| 137 | ], |
| 138 | "releaseNotes": [ # The description of what is new in the app in this release. |
| 139 | { |
| 140 | "text": "A String", # The text in the given `language`. |
| 141 | "language": "A String", # The language code, in BCP 47 format (eg "en-US"). |
| 142 | }, |
| 143 | ], |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 144 | "controls": [ |
| 145 | { |
| 146 | "stratifiedSamplings": [ |
| 147 | { |
| 148 | "modRanges": [ |
| 149 | { |
| 150 | "start": "A String", |
| 151 | "end": "A String", |
| 152 | }, |
| 153 | ], |
| 154 | "stratum": { |
| 155 | "brand": "A String", |
| 156 | }, |
| 157 | }, |
| 158 | ], |
| 159 | "modRanges": [ |
| 160 | { |
| 161 | "start": "A String", |
| 162 | "end": "A String", |
| 163 | }, |
| 164 | ], |
| 165 | "versionCodes": [ |
| 166 | "A String", |
| 167 | ], |
| 168 | }, |
| 169 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 170 | "countryTargeting": { |
| 171 | "includeRestOfWorld": True or False, |
| 172 | "countries": [ |
| 173 | "A String", |
| 174 | ], |
| 175 | }, |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 176 | "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted". |
| 177 | "rollbackEnabled": True or False, |
| 178 | "inAppUpdatePriority": 42, # In-app update priority of the release. All newly added APKs in the release will be considered at this priority. in_app_update_priority can take values between [0, 5]. 5 is the highest priority. Default priority is 0. in_app_update_priority can not be updated once the release is rolled out. See https://developer.android.com/guide/playcore/in-app-updates. |
| 179 | "sampling": { |
| 180 | "stratifiedSamplings": [ |
| 181 | { |
| 182 | "modRanges": [ |
| 183 | { |
| 184 | "start": "A String", |
| 185 | "end": "A String", |
| 186 | }, |
| 187 | ], |
| 188 | "stratum": { |
| 189 | "brand": "A String", |
| 190 | }, |
| 191 | }, |
| 192 | ], |
| 193 | "salt": 42, |
| 194 | "modRanges": [ |
| 195 | { |
| 196 | "start": "A String", |
| 197 | "end": "A String", |
| 198 | }, |
| 199 | ], |
| 200 | "modulus": "A String", |
| 201 | "useAndroidId": True or False, |
| 202 | }, |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 203 | }, |
| 204 | ], |
| 205 | }</pre> |
| 206 | </div> |
| 207 | |
| 208 | <div class="method"> |
| 209 | <code class="details" id="list">list(packageName, editId)</code> |
| 210 | <pre>Lists all the track configurations for this edit. |
| 211 | |
| 212 | Args: |
| 213 | packageName: string, Unique identifier for the Android app that is being updated; for example, "com.spiffygame". (required) |
| 214 | editId: string, Unique identifier for this edit. (required) |
| 215 | |
| 216 | Returns: |
| 217 | An object of the form: |
| 218 | |
| 219 | { |
| 220 | "kind": "androidpublisher#tracksListResponse", # Identifies what kind of resource this is. Value: the fixed string "androidpublisher#tracksListResponse". |
| 221 | "tracks": [ |
| 222 | { |
| 223 | "track": "A String", # Identifier for this track. |
| 224 | "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes. |
| 225 | { |
| 226 | "status": "A String", # The desired status of this release. |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 227 | "pinnedVersions": [ |
| 228 | { |
| 229 | "versionCodes": [ |
| 230 | "A String", |
| 231 | ], |
| 232 | "targetings": [ |
| 233 | { |
| 234 | "countryCodes": [ |
| 235 | "A String", |
| 236 | ], |
| 237 | "phoneskyVersions": [ |
| 238 | "A String", |
| 239 | ], |
| 240 | "sdkVersions": [ |
| 241 | 42, |
| 242 | ], |
| 243 | "devices": [ |
| 244 | { |
| 245 | "device": "A String", |
| 246 | "brand": "A String", |
| 247 | "product": "A String", |
| 248 | }, |
| 249 | ], |
| 250 | }, |
| 251 | ], |
| 252 | }, |
| 253 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 254 | "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs. |
| 255 | "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases. |
| 256 | "A String", |
| 257 | ], |
| 258 | "releaseNotes": [ # The description of what is new in the app in this release. |
| 259 | { |
| 260 | "text": "A String", # The text in the given `language`. |
| 261 | "language": "A String", # The language code, in BCP 47 format (eg "en-US"). |
| 262 | }, |
| 263 | ], |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 264 | "controls": [ |
| 265 | { |
| 266 | "stratifiedSamplings": [ |
| 267 | { |
| 268 | "modRanges": [ |
| 269 | { |
| 270 | "start": "A String", |
| 271 | "end": "A String", |
| 272 | }, |
| 273 | ], |
| 274 | "stratum": { |
| 275 | "brand": "A String", |
| 276 | }, |
| 277 | }, |
| 278 | ], |
| 279 | "modRanges": [ |
| 280 | { |
| 281 | "start": "A String", |
| 282 | "end": "A String", |
| 283 | }, |
| 284 | ], |
| 285 | "versionCodes": [ |
| 286 | "A String", |
| 287 | ], |
| 288 | }, |
| 289 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 290 | "countryTargeting": { |
| 291 | "includeRestOfWorld": True or False, |
| 292 | "countries": [ |
| 293 | "A String", |
| 294 | ], |
| 295 | }, |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 296 | "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted". |
| 297 | "rollbackEnabled": True or False, |
| 298 | "inAppUpdatePriority": 42, # In-app update priority of the release. All newly added APKs in the release will be considered at this priority. in_app_update_priority can take values between [0, 5]. 5 is the highest priority. Default priority is 0. in_app_update_priority can not be updated once the release is rolled out. See https://developer.android.com/guide/playcore/in-app-updates. |
| 299 | "sampling": { |
| 300 | "stratifiedSamplings": [ |
| 301 | { |
| 302 | "modRanges": [ |
| 303 | { |
| 304 | "start": "A String", |
| 305 | "end": "A String", |
| 306 | }, |
| 307 | ], |
| 308 | "stratum": { |
| 309 | "brand": "A String", |
| 310 | }, |
| 311 | }, |
| 312 | ], |
| 313 | "salt": 42, |
| 314 | "modRanges": [ |
| 315 | { |
| 316 | "start": "A String", |
| 317 | "end": "A String", |
| 318 | }, |
| 319 | ], |
| 320 | "modulus": "A String", |
| 321 | "useAndroidId": True or False, |
| 322 | }, |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 323 | }, |
| 324 | ], |
| 325 | }, |
| 326 | ], |
| 327 | }</pre> |
| 328 | </div> |
| 329 | |
| 330 | <div class="method"> |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 331 | <code class="details" id="patch">patch(packageName, editId, track, body=None)</code> |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 332 | <pre>Updates the track configuration for the specified track type. This method supports patch semantics. |
| 333 | |
| 334 | Args: |
| 335 | packageName: string, Unique identifier for the Android app that is being updated; for example, "com.spiffygame". (required) |
| 336 | editId: string, Unique identifier for this edit. (required) |
| 337 | track: string, The track to read or modify. (required) |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 338 | body: object, The request body. |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 339 | The object takes the form of: |
| 340 | |
| 341 | { |
| 342 | "track": "A String", # Identifier for this track. |
| 343 | "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes. |
| 344 | { |
| 345 | "status": "A String", # The desired status of this release. |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 346 | "pinnedVersions": [ |
| 347 | { |
| 348 | "versionCodes": [ |
| 349 | "A String", |
| 350 | ], |
| 351 | "targetings": [ |
| 352 | { |
| 353 | "countryCodes": [ |
| 354 | "A String", |
| 355 | ], |
| 356 | "phoneskyVersions": [ |
| 357 | "A String", |
| 358 | ], |
| 359 | "sdkVersions": [ |
| 360 | 42, |
| 361 | ], |
| 362 | "devices": [ |
| 363 | { |
| 364 | "device": "A String", |
| 365 | "brand": "A String", |
| 366 | "product": "A String", |
| 367 | }, |
| 368 | ], |
| 369 | }, |
| 370 | ], |
| 371 | }, |
| 372 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 373 | "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs. |
| 374 | "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases. |
| 375 | "A String", |
| 376 | ], |
| 377 | "releaseNotes": [ # The description of what is new in the app in this release. |
| 378 | { |
| 379 | "text": "A String", # The text in the given `language`. |
| 380 | "language": "A String", # The language code, in BCP 47 format (eg "en-US"). |
| 381 | }, |
| 382 | ], |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 383 | "controls": [ |
| 384 | { |
| 385 | "stratifiedSamplings": [ |
| 386 | { |
| 387 | "modRanges": [ |
| 388 | { |
| 389 | "start": "A String", |
| 390 | "end": "A String", |
| 391 | }, |
| 392 | ], |
| 393 | "stratum": { |
| 394 | "brand": "A String", |
| 395 | }, |
| 396 | }, |
| 397 | ], |
| 398 | "modRanges": [ |
| 399 | { |
| 400 | "start": "A String", |
| 401 | "end": "A String", |
| 402 | }, |
| 403 | ], |
| 404 | "versionCodes": [ |
| 405 | "A String", |
| 406 | ], |
| 407 | }, |
| 408 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 409 | "countryTargeting": { |
| 410 | "includeRestOfWorld": True or False, |
| 411 | "countries": [ |
| 412 | "A String", |
| 413 | ], |
| 414 | }, |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 415 | "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted". |
| 416 | "rollbackEnabled": True or False, |
| 417 | "inAppUpdatePriority": 42, # In-app update priority of the release. All newly added APKs in the release will be considered at this priority. in_app_update_priority can take values between [0, 5]. 5 is the highest priority. Default priority is 0. in_app_update_priority can not be updated once the release is rolled out. See https://developer.android.com/guide/playcore/in-app-updates. |
| 418 | "sampling": { |
| 419 | "stratifiedSamplings": [ |
| 420 | { |
| 421 | "modRanges": [ |
| 422 | { |
| 423 | "start": "A String", |
| 424 | "end": "A String", |
| 425 | }, |
| 426 | ], |
| 427 | "stratum": { |
| 428 | "brand": "A String", |
| 429 | }, |
| 430 | }, |
| 431 | ], |
| 432 | "salt": 42, |
| 433 | "modRanges": [ |
| 434 | { |
| 435 | "start": "A String", |
| 436 | "end": "A String", |
| 437 | }, |
| 438 | ], |
| 439 | "modulus": "A String", |
| 440 | "useAndroidId": True or False, |
| 441 | }, |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 442 | }, |
| 443 | ], |
| 444 | } |
| 445 | |
| 446 | |
| 447 | Returns: |
| 448 | An object of the form: |
| 449 | |
| 450 | { |
| 451 | "track": "A String", # Identifier for this track. |
| 452 | "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes. |
| 453 | { |
| 454 | "status": "A String", # The desired status of this release. |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 455 | "pinnedVersions": [ |
| 456 | { |
| 457 | "versionCodes": [ |
| 458 | "A String", |
| 459 | ], |
| 460 | "targetings": [ |
| 461 | { |
| 462 | "countryCodes": [ |
| 463 | "A String", |
| 464 | ], |
| 465 | "phoneskyVersions": [ |
| 466 | "A String", |
| 467 | ], |
| 468 | "sdkVersions": [ |
| 469 | 42, |
| 470 | ], |
| 471 | "devices": [ |
| 472 | { |
| 473 | "device": "A String", |
| 474 | "brand": "A String", |
| 475 | "product": "A String", |
| 476 | }, |
| 477 | ], |
| 478 | }, |
| 479 | ], |
| 480 | }, |
| 481 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 482 | "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs. |
| 483 | "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases. |
| 484 | "A String", |
| 485 | ], |
| 486 | "releaseNotes": [ # The description of what is new in the app in this release. |
| 487 | { |
| 488 | "text": "A String", # The text in the given `language`. |
| 489 | "language": "A String", # The language code, in BCP 47 format (eg "en-US"). |
| 490 | }, |
| 491 | ], |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 492 | "controls": [ |
| 493 | { |
| 494 | "stratifiedSamplings": [ |
| 495 | { |
| 496 | "modRanges": [ |
| 497 | { |
| 498 | "start": "A String", |
| 499 | "end": "A String", |
| 500 | }, |
| 501 | ], |
| 502 | "stratum": { |
| 503 | "brand": "A String", |
| 504 | }, |
| 505 | }, |
| 506 | ], |
| 507 | "modRanges": [ |
| 508 | { |
| 509 | "start": "A String", |
| 510 | "end": "A String", |
| 511 | }, |
| 512 | ], |
| 513 | "versionCodes": [ |
| 514 | "A String", |
| 515 | ], |
| 516 | }, |
| 517 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 518 | "countryTargeting": { |
| 519 | "includeRestOfWorld": True or False, |
| 520 | "countries": [ |
| 521 | "A String", |
| 522 | ], |
| 523 | }, |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 524 | "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted". |
| 525 | "rollbackEnabled": True or False, |
| 526 | "inAppUpdatePriority": 42, # In-app update priority of the release. All newly added APKs in the release will be considered at this priority. in_app_update_priority can take values between [0, 5]. 5 is the highest priority. Default priority is 0. in_app_update_priority can not be updated once the release is rolled out. See https://developer.android.com/guide/playcore/in-app-updates. |
| 527 | "sampling": { |
| 528 | "stratifiedSamplings": [ |
| 529 | { |
| 530 | "modRanges": [ |
| 531 | { |
| 532 | "start": "A String", |
| 533 | "end": "A String", |
| 534 | }, |
| 535 | ], |
| 536 | "stratum": { |
| 537 | "brand": "A String", |
| 538 | }, |
| 539 | }, |
| 540 | ], |
| 541 | "salt": 42, |
| 542 | "modRanges": [ |
| 543 | { |
| 544 | "start": "A String", |
| 545 | "end": "A String", |
| 546 | }, |
| 547 | ], |
| 548 | "modulus": "A String", |
| 549 | "useAndroidId": True or False, |
| 550 | }, |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 551 | }, |
| 552 | ], |
| 553 | }</pre> |
| 554 | </div> |
| 555 | |
| 556 | <div class="method"> |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 557 | <code class="details" id="update">update(packageName, editId, track, body=None)</code> |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 558 | <pre>Updates the track configuration for the specified track type. |
| 559 | |
| 560 | Args: |
| 561 | packageName: string, Unique identifier for the Android app that is being updated; for example, "com.spiffygame". (required) |
| 562 | editId: string, Unique identifier for this edit. (required) |
| 563 | track: string, The track to read or modify. (required) |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 564 | body: object, The request body. |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 565 | The object takes the form of: |
| 566 | |
| 567 | { |
| 568 | "track": "A String", # Identifier for this track. |
| 569 | "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes. |
| 570 | { |
| 571 | "status": "A String", # The desired status of this release. |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 572 | "pinnedVersions": [ |
| 573 | { |
| 574 | "versionCodes": [ |
| 575 | "A String", |
| 576 | ], |
| 577 | "targetings": [ |
| 578 | { |
| 579 | "countryCodes": [ |
| 580 | "A String", |
| 581 | ], |
| 582 | "phoneskyVersions": [ |
| 583 | "A String", |
| 584 | ], |
| 585 | "sdkVersions": [ |
| 586 | 42, |
| 587 | ], |
| 588 | "devices": [ |
| 589 | { |
| 590 | "device": "A String", |
| 591 | "brand": "A String", |
| 592 | "product": "A String", |
| 593 | }, |
| 594 | ], |
| 595 | }, |
| 596 | ], |
| 597 | }, |
| 598 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 599 | "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs. |
| 600 | "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases. |
| 601 | "A String", |
| 602 | ], |
| 603 | "releaseNotes": [ # The description of what is new in the app in this release. |
| 604 | { |
| 605 | "text": "A String", # The text in the given `language`. |
| 606 | "language": "A String", # The language code, in BCP 47 format (eg "en-US"). |
| 607 | }, |
| 608 | ], |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 609 | "controls": [ |
| 610 | { |
| 611 | "stratifiedSamplings": [ |
| 612 | { |
| 613 | "modRanges": [ |
| 614 | { |
| 615 | "start": "A String", |
| 616 | "end": "A String", |
| 617 | }, |
| 618 | ], |
| 619 | "stratum": { |
| 620 | "brand": "A String", |
| 621 | }, |
| 622 | }, |
| 623 | ], |
| 624 | "modRanges": [ |
| 625 | { |
| 626 | "start": "A String", |
| 627 | "end": "A String", |
| 628 | }, |
| 629 | ], |
| 630 | "versionCodes": [ |
| 631 | "A String", |
| 632 | ], |
| 633 | }, |
| 634 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 635 | "countryTargeting": { |
| 636 | "includeRestOfWorld": True or False, |
| 637 | "countries": [ |
| 638 | "A String", |
| 639 | ], |
| 640 | }, |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 641 | "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted". |
| 642 | "rollbackEnabled": True or False, |
| 643 | "inAppUpdatePriority": 42, # In-app update priority of the release. All newly added APKs in the release will be considered at this priority. in_app_update_priority can take values between [0, 5]. 5 is the highest priority. Default priority is 0. in_app_update_priority can not be updated once the release is rolled out. See https://developer.android.com/guide/playcore/in-app-updates. |
| 644 | "sampling": { |
| 645 | "stratifiedSamplings": [ |
| 646 | { |
| 647 | "modRanges": [ |
| 648 | { |
| 649 | "start": "A String", |
| 650 | "end": "A String", |
| 651 | }, |
| 652 | ], |
| 653 | "stratum": { |
| 654 | "brand": "A String", |
| 655 | }, |
| 656 | }, |
| 657 | ], |
| 658 | "salt": 42, |
| 659 | "modRanges": [ |
| 660 | { |
| 661 | "start": "A String", |
| 662 | "end": "A String", |
| 663 | }, |
| 664 | ], |
| 665 | "modulus": "A String", |
| 666 | "useAndroidId": True or False, |
| 667 | }, |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 668 | }, |
| 669 | ], |
| 670 | } |
| 671 | |
| 672 | |
| 673 | Returns: |
| 674 | An object of the form: |
| 675 | |
| 676 | { |
| 677 | "track": "A String", # Identifier for this track. |
| 678 | "releases": [ # A list of all active releases in this track during a read request. On an update request, it represents desired changes. |
| 679 | { |
| 680 | "status": "A String", # The desired status of this release. |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 681 | "pinnedVersions": [ |
| 682 | { |
| 683 | "versionCodes": [ |
| 684 | "A String", |
| 685 | ], |
| 686 | "targetings": [ |
| 687 | { |
| 688 | "countryCodes": [ |
| 689 | "A String", |
| 690 | ], |
| 691 | "phoneskyVersions": [ |
| 692 | "A String", |
| 693 | ], |
| 694 | "sdkVersions": [ |
| 695 | 42, |
| 696 | ], |
| 697 | "devices": [ |
| 698 | { |
| 699 | "device": "A String", |
| 700 | "brand": "A String", |
| 701 | "product": "A String", |
| 702 | }, |
| 703 | ], |
| 704 | }, |
| 705 | ], |
| 706 | }, |
| 707 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 708 | "name": "A String", # The release name, used to identify this release in the Play Console UI. Not required to be unique. This is optional, if not set it will be generated from the version_name in the APKs. |
| 709 | "versionCodes": [ # A list of all version codes of APKs that will be exposed to the users of this track when this release is rolled out. Note that this list should contain all versions you wish to be active, including those you wish to retain from previous releases. |
| 710 | "A String", |
| 711 | ], |
| 712 | "releaseNotes": [ # The description of what is new in the app in this release. |
| 713 | { |
| 714 | "text": "A String", # The text in the given `language`. |
| 715 | "language": "A String", # The language code, in BCP 47 format (eg "en-US"). |
| 716 | }, |
| 717 | ], |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 718 | "controls": [ |
| 719 | { |
| 720 | "stratifiedSamplings": [ |
| 721 | { |
| 722 | "modRanges": [ |
| 723 | { |
| 724 | "start": "A String", |
| 725 | "end": "A String", |
| 726 | }, |
| 727 | ], |
| 728 | "stratum": { |
| 729 | "brand": "A String", |
| 730 | }, |
| 731 | }, |
| 732 | ], |
| 733 | "modRanges": [ |
| 734 | { |
| 735 | "start": "A String", |
| 736 | "end": "A String", |
| 737 | }, |
| 738 | ], |
| 739 | "versionCodes": [ |
| 740 | "A String", |
| 741 | ], |
| 742 | }, |
| 743 | ], |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 744 | "countryTargeting": { |
| 745 | "includeRestOfWorld": True or False, |
| 746 | "countries": [ |
| 747 | "A String", |
| 748 | ], |
| 749 | }, |
Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame^] | 750 | "userFraction": 3.14, # Fraction of users who are eligible to receive the release. 0 < fraction < 1. To be set, release status must be "inProgress" or "halted". |
| 751 | "rollbackEnabled": True or False, |
| 752 | "inAppUpdatePriority": 42, # In-app update priority of the release. All newly added APKs in the release will be considered at this priority. in_app_update_priority can take values between [0, 5]. 5 is the highest priority. Default priority is 0. in_app_update_priority can not be updated once the release is rolled out. See https://developer.android.com/guide/playcore/in-app-updates. |
| 753 | "sampling": { |
| 754 | "stratifiedSamplings": [ |
| 755 | { |
| 756 | "modRanges": [ |
| 757 | { |
| 758 | "start": "A String", |
| 759 | "end": "A String", |
| 760 | }, |
| 761 | ], |
| 762 | "stratum": { |
| 763 | "brand": "A String", |
| 764 | }, |
| 765 | }, |
| 766 | ], |
| 767 | "salt": 42, |
| 768 | "modRanges": [ |
| 769 | { |
| 770 | "start": "A String", |
| 771 | "end": "A String", |
| 772 | }, |
| 773 | ], |
| 774 | "modulus": "A String", |
| 775 | "useAndroidId": True or False, |
| 776 | }, |
Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 777 | }, |
| 778 | ], |
| 779 | }</pre> |
| 780 | </div> |
| 781 | |
| 782 | </body></html> |