1<html><body> 2<style> 3 4body, 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 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, 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_v2.html">Google Play Developer API</a> . <a href="androidpublisher_v2.inappproducts.html">inappproducts</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#delete">delete(packageName, sku)</a></code></p> 79<p class="firstline">Delete an in-app product for an app.</p> 80<p class="toc_element"> 81 <code><a href="#get">get(packageName, sku)</a></code></p> 82<p class="firstline">Returns information about the in-app product specified.</p> 83<p class="toc_element"> 84 <code><a href="#insert">insert(packageName, body, autoConvertMissingPrices=None)</a></code></p> 85<p class="firstline">Creates a new in-app product for an app.</p> 86<p class="toc_element"> 87 <code><a href="#list">list(packageName, token=None, maxResults=None, startIndex=None)</a></code></p> 88<p class="firstline">List all the in-app products for an Android app, both subscriptions and managed in-app products..</p> 89<p class="toc_element"> 90 <code><a href="#patch">patch(packageName, sku, body, autoConvertMissingPrices=None)</a></code></p> 91<p class="firstline">Updates the details of an in-app product. This method supports patch semantics.</p> 92<p class="toc_element"> 93 <code><a href="#update">update(packageName, sku, body, autoConvertMissingPrices=None)</a></code></p> 94<p class="firstline">Updates the details of an in-app product.</p> 95<h3>Method Details</h3> 96<div class="method"> 97 <code class="details" id="delete">delete(packageName, sku)</code> 98 <pre>Delete an in-app product for an app. 99 100Args: 101 packageName: string, Unique identifier for the Android app with the in-app product; for example, "com.spiffygame". (required) 102 sku: string, Unique identifier for the in-app product. (required) 103</pre> 104</div> 105 106<div class="method"> 107 <code class="details" id="get">get(packageName, sku)</code> 108 <pre>Returns information about the in-app product specified. 109 110Args: 111 packageName: string, A parameter (required) 112 sku: string, Unique identifier for the in-app product. (required) 113 114Returns: 115 An object of the form: 116 117 { 118 "sku": "A String", # The stock-keeping-unit (SKU) of the product, unique within an app. 119 "status": "A String", 120 "subscriptionPeriod": "A String", # Subscription period, specified in ISO 8601 format. Acceptable values are "P1W" (one week), "P1M" (one month), "P3M" (three months), "P6M" (six months), and "P1Y" (one year). 121 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. It will allow developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values = "P3D" (three days) and "P7D" (seven days) 122 "season": { # Definition of a season for a seasonal subscription. Can be defined only for yearly subscriptions. 123 "prorations": [ # Optionally present list of prorations for the season. Each proration is a one-off discounted entry into a subscription. Each proration contains the first date on which the discount is available and the new pricing information. 124 { 125 "start": { # Defines the first day on which the price takes effect. 126 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 127 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 128 }, 129 "defaultPrice": { # Default price cannot be zero and must be less than the full subscription price. Default price is always in the developer's Checkout merchant currency. Targeted countries have their prices set automatically based on the default_price. 130 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 131 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 132 }, 133 }, 134 ], 135 "end": { # Inclusive end date of the recurrence period. 136 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 137 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 138 }, 139 "start": { # Inclusive start date of the recurrence period. 140 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 141 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 142 }, 143 }, 144 "packageName": "A String", # The package name of the parent app. 145 "listings": { # List of localized title and description data. 146 "a_key": { # The language of the localized data, as defined by BCP 47. i.e.: "en-US", "en-GB". 147 "description": "A String", 148 "title": "A String", 149 }, 150 }, 151 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between "P7D" (seven days) and "P999D" (999 days). Seasonal subscriptions cannot have a trial period. 152 "purchaseType": "A String", # Purchase type enum value. Unmodifiable after creation. 153 "defaultLanguage": "A String", # The default language of the localized data, as defined by BCP 47. e.g. "en-US", "en-GB". 154 "prices": { # Prices per buyer region. None of these prices should be zero. In-app products can never be free. 155 "a_key": { # Region code, as defined by ISO 3166-2. 156 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 157 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 158 }, 159 }, 160 "defaultPrice": { # Default price cannot be zero. In-app products can never be free. Default price is always in the developer's Checkout merchant currency. 161 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 162 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 163 }, 164 }</pre> 165</div> 166 167<div class="method"> 168 <code class="details" id="insert">insert(packageName, body, autoConvertMissingPrices=None)</code> 169 <pre>Creates a new in-app product for an app. 170 171Args: 172 packageName: string, Unique identifier for the Android app; for example, "com.spiffygame". (required) 173 body: object, The request body. (required) 174 The object takes the form of: 175 176{ 177 "sku": "A String", # The stock-keeping-unit (SKU) of the product, unique within an app. 178 "status": "A String", 179 "subscriptionPeriod": "A String", # Subscription period, specified in ISO 8601 format. Acceptable values are "P1W" (one week), "P1M" (one month), "P3M" (three months), "P6M" (six months), and "P1Y" (one year). 180 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. It will allow developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values = "P3D" (three days) and "P7D" (seven days) 181 "season": { # Definition of a season for a seasonal subscription. Can be defined only for yearly subscriptions. 182 "prorations": [ # Optionally present list of prorations for the season. Each proration is a one-off discounted entry into a subscription. Each proration contains the first date on which the discount is available and the new pricing information. 183 { 184 "start": { # Defines the first day on which the price takes effect. 185 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 186 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 187 }, 188 "defaultPrice": { # Default price cannot be zero and must be less than the full subscription price. Default price is always in the developer's Checkout merchant currency. Targeted countries have their prices set automatically based on the default_price. 189 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 190 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 191 }, 192 }, 193 ], 194 "end": { # Inclusive end date of the recurrence period. 195 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 196 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 197 }, 198 "start": { # Inclusive start date of the recurrence period. 199 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 200 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 201 }, 202 }, 203 "packageName": "A String", # The package name of the parent app. 204 "listings": { # List of localized title and description data. 205 "a_key": { # The language of the localized data, as defined by BCP 47. i.e.: "en-US", "en-GB". 206 "description": "A String", 207 "title": "A String", 208 }, 209 }, 210 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between "P7D" (seven days) and "P999D" (999 days). Seasonal subscriptions cannot have a trial period. 211 "purchaseType": "A String", # Purchase type enum value. Unmodifiable after creation. 212 "defaultLanguage": "A String", # The default language of the localized data, as defined by BCP 47. e.g. "en-US", "en-GB". 213 "prices": { # Prices per buyer region. None of these prices should be zero. In-app products can never be free. 214 "a_key": { # Region code, as defined by ISO 3166-2. 215 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 216 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 217 }, 218 }, 219 "defaultPrice": { # Default price cannot be zero. In-app products can never be free. Default price is always in the developer's Checkout merchant currency. 220 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 221 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 222 }, 223 } 224 225 autoConvertMissingPrices: boolean, If true the prices for all regions targeted by the parent app that don't have a price specified for this in-app product will be auto converted to the target currency based on the default price. Defaults to false. 226 227Returns: 228 An object of the form: 229 230 { 231 "sku": "A String", # The stock-keeping-unit (SKU) of the product, unique within an app. 232 "status": "A String", 233 "subscriptionPeriod": "A String", # Subscription period, specified in ISO 8601 format. Acceptable values are "P1W" (one week), "P1M" (one month), "P3M" (three months), "P6M" (six months), and "P1Y" (one year). 234 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. It will allow developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values = "P3D" (three days) and "P7D" (seven days) 235 "season": { # Definition of a season for a seasonal subscription. Can be defined only for yearly subscriptions. 236 "prorations": [ # Optionally present list of prorations for the season. Each proration is a one-off discounted entry into a subscription. Each proration contains the first date on which the discount is available and the new pricing information. 237 { 238 "start": { # Defines the first day on which the price takes effect. 239 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 240 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 241 }, 242 "defaultPrice": { # Default price cannot be zero and must be less than the full subscription price. Default price is always in the developer's Checkout merchant currency. Targeted countries have their prices set automatically based on the default_price. 243 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 244 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 245 }, 246 }, 247 ], 248 "end": { # Inclusive end date of the recurrence period. 249 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 250 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 251 }, 252 "start": { # Inclusive start date of the recurrence period. 253 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 254 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 255 }, 256 }, 257 "packageName": "A String", # The package name of the parent app. 258 "listings": { # List of localized title and description data. 259 "a_key": { # The language of the localized data, as defined by BCP 47. i.e.: "en-US", "en-GB". 260 "description": "A String", 261 "title": "A String", 262 }, 263 }, 264 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between "P7D" (seven days) and "P999D" (999 days). Seasonal subscriptions cannot have a trial period. 265 "purchaseType": "A String", # Purchase type enum value. Unmodifiable after creation. 266 "defaultLanguage": "A String", # The default language of the localized data, as defined by BCP 47. e.g. "en-US", "en-GB". 267 "prices": { # Prices per buyer region. None of these prices should be zero. In-app products can never be free. 268 "a_key": { # Region code, as defined by ISO 3166-2. 269 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 270 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 271 }, 272 }, 273 "defaultPrice": { # Default price cannot be zero. In-app products can never be free. Default price is always in the developer's Checkout merchant currency. 274 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 275 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 276 }, 277 }</pre> 278</div> 279 280<div class="method"> 281 <code class="details" id="list">list(packageName, token=None, maxResults=None, startIndex=None)</code> 282 <pre>List all the in-app products for an Android app, both subscriptions and managed in-app products.. 283 284Args: 285 packageName: string, Unique identifier for the Android app with in-app products; for example, "com.spiffygame". (required) 286 token: string, A parameter 287 maxResults: integer, A parameter 288 startIndex: integer, A parameter 289 290Returns: 291 An object of the form: 292 293 { 294 "kind": "androidpublisher#inappproductsListResponse", # Identifies what kind of resource this is. Value: the fixed string "androidpublisher#inappproductsListResponse". 295 "tokenPagination": { 296 "nextPageToken": "A String", 297 "previousPageToken": "A String", 298 }, 299 "pageInfo": { 300 "totalResults": 42, 301 "startIndex": 42, 302 "resultPerPage": 42, 303 }, 304 "inappproduct": [ 305 { 306 "sku": "A String", # The stock-keeping-unit (SKU) of the product, unique within an app. 307 "status": "A String", 308 "subscriptionPeriod": "A String", # Subscription period, specified in ISO 8601 format. Acceptable values are "P1W" (one week), "P1M" (one month), "P3M" (three months), "P6M" (six months), and "P1Y" (one year). 309 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. It will allow developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values = "P3D" (three days) and "P7D" (seven days) 310 "season": { # Definition of a season for a seasonal subscription. Can be defined only for yearly subscriptions. 311 "prorations": [ # Optionally present list of prorations for the season. Each proration is a one-off discounted entry into a subscription. Each proration contains the first date on which the discount is available and the new pricing information. 312 { 313 "start": { # Defines the first day on which the price takes effect. 314 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 315 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 316 }, 317 "defaultPrice": { # Default price cannot be zero and must be less than the full subscription price. Default price is always in the developer's Checkout merchant currency. Targeted countries have their prices set automatically based on the default_price. 318 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 319 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 320 }, 321 }, 322 ], 323 "end": { # Inclusive end date of the recurrence period. 324 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 325 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 326 }, 327 "start": { # Inclusive start date of the recurrence period. 328 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 329 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 330 }, 331 }, 332 "packageName": "A String", # The package name of the parent app. 333 "listings": { # List of localized title and description data. 334 "a_key": { # The language of the localized data, as defined by BCP 47. i.e.: "en-US", "en-GB". 335 "description": "A String", 336 "title": "A String", 337 }, 338 }, 339 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between "P7D" (seven days) and "P999D" (999 days). Seasonal subscriptions cannot have a trial period. 340 "purchaseType": "A String", # Purchase type enum value. Unmodifiable after creation. 341 "defaultLanguage": "A String", # The default language of the localized data, as defined by BCP 47. e.g. "en-US", "en-GB". 342 "prices": { # Prices per buyer region. None of these prices should be zero. In-app products can never be free. 343 "a_key": { # Region code, as defined by ISO 3166-2. 344 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 345 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 346 }, 347 }, 348 "defaultPrice": { # Default price cannot be zero. In-app products can never be free. Default price is always in the developer's Checkout merchant currency. 349 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 350 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 351 }, 352 }, 353 ], 354 }</pre> 355</div> 356 357<div class="method"> 358 <code class="details" id="patch">patch(packageName, sku, body, autoConvertMissingPrices=None)</code> 359 <pre>Updates the details of an in-app product. This method supports patch semantics. 360 361Args: 362 packageName: string, Unique identifier for the Android app with the in-app product; for example, "com.spiffygame". (required) 363 sku: string, Unique identifier for the in-app product. (required) 364 body: object, The request body. (required) 365 The object takes the form of: 366 367{ 368 "sku": "A String", # The stock-keeping-unit (SKU) of the product, unique within an app. 369 "status": "A String", 370 "subscriptionPeriod": "A String", # Subscription period, specified in ISO 8601 format. Acceptable values are "P1W" (one week), "P1M" (one month), "P3M" (three months), "P6M" (six months), and "P1Y" (one year). 371 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. It will allow developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values = "P3D" (three days) and "P7D" (seven days) 372 "season": { # Definition of a season for a seasonal subscription. Can be defined only for yearly subscriptions. 373 "prorations": [ # Optionally present list of prorations for the season. Each proration is a one-off discounted entry into a subscription. Each proration contains the first date on which the discount is available and the new pricing information. 374 { 375 "start": { # Defines the first day on which the price takes effect. 376 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 377 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 378 }, 379 "defaultPrice": { # Default price cannot be zero and must be less than the full subscription price. Default price is always in the developer's Checkout merchant currency. Targeted countries have their prices set automatically based on the default_price. 380 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 381 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 382 }, 383 }, 384 ], 385 "end": { # Inclusive end date of the recurrence period. 386 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 387 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 388 }, 389 "start": { # Inclusive start date of the recurrence period. 390 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 391 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 392 }, 393 }, 394 "packageName": "A String", # The package name of the parent app. 395 "listings": { # List of localized title and description data. 396 "a_key": { # The language of the localized data, as defined by BCP 47. i.e.: "en-US", "en-GB". 397 "description": "A String", 398 "title": "A String", 399 }, 400 }, 401 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between "P7D" (seven days) and "P999D" (999 days). Seasonal subscriptions cannot have a trial period. 402 "purchaseType": "A String", # Purchase type enum value. Unmodifiable after creation. 403 "defaultLanguage": "A String", # The default language of the localized data, as defined by BCP 47. e.g. "en-US", "en-GB". 404 "prices": { # Prices per buyer region. None of these prices should be zero. In-app products can never be free. 405 "a_key": { # Region code, as defined by ISO 3166-2. 406 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 407 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 408 }, 409 }, 410 "defaultPrice": { # Default price cannot be zero. In-app products can never be free. Default price is always in the developer's Checkout merchant currency. 411 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 412 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 413 }, 414 } 415 416 autoConvertMissingPrices: boolean, If true the prices for all regions targeted by the parent app that don't have a price specified for this in-app product will be auto converted to the target currency based on the default price. Defaults to false. 417 418Returns: 419 An object of the form: 420 421 { 422 "sku": "A String", # The stock-keeping-unit (SKU) of the product, unique within an app. 423 "status": "A String", 424 "subscriptionPeriod": "A String", # Subscription period, specified in ISO 8601 format. Acceptable values are "P1W" (one week), "P1M" (one month), "P3M" (three months), "P6M" (six months), and "P1Y" (one year). 425 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. It will allow developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values = "P3D" (three days) and "P7D" (seven days) 426 "season": { # Definition of a season for a seasonal subscription. Can be defined only for yearly subscriptions. 427 "prorations": [ # Optionally present list of prorations for the season. Each proration is a one-off discounted entry into a subscription. Each proration contains the first date on which the discount is available and the new pricing information. 428 { 429 "start": { # Defines the first day on which the price takes effect. 430 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 431 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 432 }, 433 "defaultPrice": { # Default price cannot be zero and must be less than the full subscription price. Default price is always in the developer's Checkout merchant currency. Targeted countries have their prices set automatically based on the default_price. 434 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 435 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 436 }, 437 }, 438 ], 439 "end": { # Inclusive end date of the recurrence period. 440 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 441 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 442 }, 443 "start": { # Inclusive start date of the recurrence period. 444 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 445 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 446 }, 447 }, 448 "packageName": "A String", # The package name of the parent app. 449 "listings": { # List of localized title and description data. 450 "a_key": { # The language of the localized data, as defined by BCP 47. i.e.: "en-US", "en-GB". 451 "description": "A String", 452 "title": "A String", 453 }, 454 }, 455 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between "P7D" (seven days) and "P999D" (999 days). Seasonal subscriptions cannot have a trial period. 456 "purchaseType": "A String", # Purchase type enum value. Unmodifiable after creation. 457 "defaultLanguage": "A String", # The default language of the localized data, as defined by BCP 47. e.g. "en-US", "en-GB". 458 "prices": { # Prices per buyer region. None of these prices should be zero. In-app products can never be free. 459 "a_key": { # Region code, as defined by ISO 3166-2. 460 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 461 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 462 }, 463 }, 464 "defaultPrice": { # Default price cannot be zero. In-app products can never be free. Default price is always in the developer's Checkout merchant currency. 465 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 466 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 467 }, 468 }</pre> 469</div> 470 471<div class="method"> 472 <code class="details" id="update">update(packageName, sku, body, autoConvertMissingPrices=None)</code> 473 <pre>Updates the details of an in-app product. 474 475Args: 476 packageName: string, Unique identifier for the Android app with the in-app product; for example, "com.spiffygame". (required) 477 sku: string, Unique identifier for the in-app product. (required) 478 body: object, The request body. (required) 479 The object takes the form of: 480 481{ 482 "sku": "A String", # The stock-keeping-unit (SKU) of the product, unique within an app. 483 "status": "A String", 484 "subscriptionPeriod": "A String", # Subscription period, specified in ISO 8601 format. Acceptable values are "P1W" (one week), "P1M" (one month), "P3M" (three months), "P6M" (six months), and "P1Y" (one year). 485 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. It will allow developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values = "P3D" (three days) and "P7D" (seven days) 486 "season": { # Definition of a season for a seasonal subscription. Can be defined only for yearly subscriptions. 487 "prorations": [ # Optionally present list of prorations for the season. Each proration is a one-off discounted entry into a subscription. Each proration contains the first date on which the discount is available and the new pricing information. 488 { 489 "start": { # Defines the first day on which the price takes effect. 490 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 491 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 492 }, 493 "defaultPrice": { # Default price cannot be zero and must be less than the full subscription price. Default price is always in the developer's Checkout merchant currency. Targeted countries have their prices set automatically based on the default_price. 494 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 495 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 496 }, 497 }, 498 ], 499 "end": { # Inclusive end date of the recurrence period. 500 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 501 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 502 }, 503 "start": { # Inclusive start date of the recurrence period. 504 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 505 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 506 }, 507 }, 508 "packageName": "A String", # The package name of the parent app. 509 "listings": { # List of localized title and description data. 510 "a_key": { # The language of the localized data, as defined by BCP 47. i.e.: "en-US", "en-GB". 511 "description": "A String", 512 "title": "A String", 513 }, 514 }, 515 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between "P7D" (seven days) and "P999D" (999 days). Seasonal subscriptions cannot have a trial period. 516 "purchaseType": "A String", # Purchase type enum value. Unmodifiable after creation. 517 "defaultLanguage": "A String", # The default language of the localized data, as defined by BCP 47. e.g. "en-US", "en-GB". 518 "prices": { # Prices per buyer region. None of these prices should be zero. In-app products can never be free. 519 "a_key": { # Region code, as defined by ISO 3166-2. 520 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 521 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 522 }, 523 }, 524 "defaultPrice": { # Default price cannot be zero. In-app products can never be free. Default price is always in the developer's Checkout merchant currency. 525 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 526 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 527 }, 528 } 529 530 autoConvertMissingPrices: boolean, If true the prices for all regions targeted by the parent app that don't have a price specified for this in-app product will be auto converted to the target currency based on the default price. Defaults to false. 531 532Returns: 533 An object of the form: 534 535 { 536 "sku": "A String", # The stock-keeping-unit (SKU) of the product, unique within an app. 537 "status": "A String", 538 "subscriptionPeriod": "A String", # Subscription period, specified in ISO 8601 format. Acceptable values are "P1W" (one week), "P1M" (one month), "P3M" (three months), "P6M" (six months), and "P1Y" (one year). 539 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. It will allow developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values = "P3D" (three days) and "P7D" (seven days) 540 "season": { # Definition of a season for a seasonal subscription. Can be defined only for yearly subscriptions. 541 "prorations": [ # Optionally present list of prorations for the season. Each proration is a one-off discounted entry into a subscription. Each proration contains the first date on which the discount is available and the new pricing information. 542 { 543 "start": { # Defines the first day on which the price takes effect. 544 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 545 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 546 }, 547 "defaultPrice": { # Default price cannot be zero and must be less than the full subscription price. Default price is always in the developer's Checkout merchant currency. Targeted countries have their prices set automatically based on the default_price. 548 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 549 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 550 }, 551 }, 552 ], 553 "end": { # Inclusive end date of the recurrence period. 554 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 555 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 556 }, 557 "start": { # Inclusive start date of the recurrence period. 558 "day": 42, # Day of a month, value in [1, 31] range. Valid range depends on the specified month. 559 "month": 42, # Month of a year. e.g. 1 = JAN, 2 = FEB etc. 560 }, 561 }, 562 "packageName": "A String", # The package name of the parent app. 563 "listings": { # List of localized title and description data. 564 "a_key": { # The language of the localized data, as defined by BCP 47. i.e.: "en-US", "en-GB". 565 "description": "A String", 566 "title": "A String", 567 }, 568 }, 569 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between "P7D" (seven days) and "P999D" (999 days). Seasonal subscriptions cannot have a trial period. 570 "purchaseType": "A String", # Purchase type enum value. Unmodifiable after creation. 571 "defaultLanguage": "A String", # The default language of the localized data, as defined by BCP 47. e.g. "en-US", "en-GB". 572 "prices": { # Prices per buyer region. None of these prices should be zero. In-app products can never be free. 573 "a_key": { # Region code, as defined by ISO 3166-2. 574 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 575 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 576 }, 577 }, 578 "defaultPrice": { # Default price cannot be zero. In-app products can never be free. Default price is always in the developer's Checkout merchant currency. 579 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. 580 "priceMicros": "A String", # The price in millionths of the currency base unit represented as a string. 581 }, 582 }</pre> 583</div> 584 585</body></html>