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_v3.html">Google Play Android Developer API</a> . <a href="androidpublisher_v3.inappproducts.html">inappproducts</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#close">close()</a></code></p> 79<p class="firstline">Close httplib2 connections.</p> 80<p class="toc_element"> 81 <code><a href="#delete">delete(packageName, sku, x__xgafv=None)</a></code></p> 82<p class="firstline">Deletes an in-app product (i.e. a managed product or a subscriptions).</p> 83<p class="toc_element"> 84 <code><a href="#get">get(packageName, sku, x__xgafv=None)</a></code></p> 85<p class="firstline">Gets an in-app product, which can be a managed product or a subscription.</p> 86<p class="toc_element"> 87 <code><a href="#insert">insert(packageName, autoConvertMissingPrices=None, body=None, x__xgafv=None)</a></code></p> 88<p class="firstline">Creates an in-app product (i.e. a managed product or a subscriptions).</p> 89<p class="toc_element"> 90 <code><a href="#list">list(packageName, maxResults=None, startIndex=None, token=None, x__xgafv=None)</a></code></p> 91<p class="firstline">Lists all in-app products - both managed products and subscriptions. If an app has a large number of in-app products, the response may be paginated. In this case the response field `tokenPagination.nextPageToken` will be set and the caller should provide its value as a `token` request parameter to retrieve the next page.</p> 92<p class="toc_element"> 93 <code><a href="#patch">patch(packageName, sku, autoConvertMissingPrices=None, body=None, x__xgafv=None)</a></code></p> 94<p class="firstline">Patches an in-app product (i.e. a managed product or a subscriptions).</p> 95<p class="toc_element"> 96 <code><a href="#update">update(packageName, sku, allowMissing=None, autoConvertMissingPrices=None, body=None, x__xgafv=None)</a></code></p> 97<p class="firstline">Updates an in-app product (i.e. a managed product or a subscriptions).</p> 98<h3>Method Details</h3> 99<div class="method"> 100 <code class="details" id="close">close()</code> 101 <pre>Close httplib2 connections.</pre> 102</div> 103 104<div class="method"> 105 <code class="details" id="delete">delete(packageName, sku, x__xgafv=None)</code> 106 <pre>Deletes an in-app product (i.e. a managed product or a subscriptions). 107 108Args: 109 packageName: string, Package name of the app. (required) 110 sku: string, Unique identifier for the in-app product. (required) 111 x__xgafv: string, V1 error format. 112 Allowed values 113 1 - v1 error format 114 2 - v2 error format 115</pre> 116</div> 117 118<div class="method"> 119 <code class="details" id="get">get(packageName, sku, x__xgafv=None)</code> 120 <pre>Gets an in-app product, which can be a managed product or a subscription. 121 122Args: 123 packageName: string, Package name of the app. (required) 124 sku: string, Unique identifier for the in-app product. (required) 125 x__xgafv: string, V1 error format. 126 Allowed values 127 1 - v1 error format 128 2 - v2 error format 129 130Returns: 131 An object of the form: 132 133 { # An in-app product. The resource for InappproductsService. 134 "defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US". 135 "defaultPrice": { # Definition of a price, i.e. currency and units. # Default price. Cannot be zero, as in-app products are never free. Always in the developer's Checkout merchant currency. 136 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 137 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 138 }, 139 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. Allows developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values are P0D (zero days), P3D (three days), P7D (seven days), P14D (14 days), and P30D (30 days). 140 "listings": { # List of localized title and description data. Map key is the language of the localized data, as defined by BCP-47, e.g. "en-US". 141 "a_key": { # Store listing of a single in-app product. 142 "benefits": [ # Localized entitlement benefits for a subscription. 143 "A String", 144 ], 145 "description": "A String", # Description for the store listing. 146 "title": "A String", # Title for the store listing. 147 }, 148 }, 149 "managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products. 150 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 151 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 152 "a_key": { # Specified details about taxation in a given geographical region. 153 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 154 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 155 }, 156 }, 157 }, 158 "packageName": "A String", # Package name of the parent app. 159 "prices": { # Prices per buyer region. None of these can be zero, as in-app products are never free. Map key is region code, as defined by ISO 3166-2. 160 "a_key": { # Definition of a price, i.e. currency and units. 161 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 162 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 163 }, 164 }, 165 "purchaseType": "A String", # The type of the product, e.g. a recurring subscription. 166 "sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app. 167 "status": "A String", # The status of the product, e.g. whether it's active. 168 "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). 169 "subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products. 170 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 171 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 172 "a_key": { # Specified details about taxation in a given geographical region. 173 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 174 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 175 }, 176 }, 177 }, 178 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days). 179}</pre> 180</div> 181 182<div class="method"> 183 <code class="details" id="insert">insert(packageName, autoConvertMissingPrices=None, body=None, x__xgafv=None)</code> 184 <pre>Creates an in-app product (i.e. a managed product or a subscriptions). 185 186Args: 187 packageName: string, Package name of the app. (required) 188 body: object, The request body. 189 The object takes the form of: 190 191{ # An in-app product. The resource for InappproductsService. 192 "defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US". 193 "defaultPrice": { # Definition of a price, i.e. currency and units. # Default price. Cannot be zero, as in-app products are never free. Always in the developer's Checkout merchant currency. 194 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 195 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 196 }, 197 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. Allows developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values are P0D (zero days), P3D (three days), P7D (seven days), P14D (14 days), and P30D (30 days). 198 "listings": { # List of localized title and description data. Map key is the language of the localized data, as defined by BCP-47, e.g. "en-US". 199 "a_key": { # Store listing of a single in-app product. 200 "benefits": [ # Localized entitlement benefits for a subscription. 201 "A String", 202 ], 203 "description": "A String", # Description for the store listing. 204 "title": "A String", # Title for the store listing. 205 }, 206 }, 207 "managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products. 208 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 209 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 210 "a_key": { # Specified details about taxation in a given geographical region. 211 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 212 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 213 }, 214 }, 215 }, 216 "packageName": "A String", # Package name of the parent app. 217 "prices": { # Prices per buyer region. None of these can be zero, as in-app products are never free. Map key is region code, as defined by ISO 3166-2. 218 "a_key": { # Definition of a price, i.e. currency and units. 219 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 220 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 221 }, 222 }, 223 "purchaseType": "A String", # The type of the product, e.g. a recurring subscription. 224 "sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app. 225 "status": "A String", # The status of the product, e.g. whether it's active. 226 "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). 227 "subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products. 228 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 229 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 230 "a_key": { # Specified details about taxation in a given geographical region. 231 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 232 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 233 }, 234 }, 235 }, 236 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days). 237} 238 239 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. 240 x__xgafv: string, V1 error format. 241 Allowed values 242 1 - v1 error format 243 2 - v2 error format 244 245Returns: 246 An object of the form: 247 248 { # An in-app product. The resource for InappproductsService. 249 "defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US". 250 "defaultPrice": { # Definition of a price, i.e. currency and units. # Default price. Cannot be zero, as in-app products are never free. Always in the developer's Checkout merchant currency. 251 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 252 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 253 }, 254 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. Allows developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values are P0D (zero days), P3D (three days), P7D (seven days), P14D (14 days), and P30D (30 days). 255 "listings": { # List of localized title and description data. Map key is the language of the localized data, as defined by BCP-47, e.g. "en-US". 256 "a_key": { # Store listing of a single in-app product. 257 "benefits": [ # Localized entitlement benefits for a subscription. 258 "A String", 259 ], 260 "description": "A String", # Description for the store listing. 261 "title": "A String", # Title for the store listing. 262 }, 263 }, 264 "managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products. 265 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 266 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 267 "a_key": { # Specified details about taxation in a given geographical region. 268 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 269 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 270 }, 271 }, 272 }, 273 "packageName": "A String", # Package name of the parent app. 274 "prices": { # Prices per buyer region. None of these can be zero, as in-app products are never free. Map key is region code, as defined by ISO 3166-2. 275 "a_key": { # Definition of a price, i.e. currency and units. 276 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 277 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 278 }, 279 }, 280 "purchaseType": "A String", # The type of the product, e.g. a recurring subscription. 281 "sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app. 282 "status": "A String", # The status of the product, e.g. whether it's active. 283 "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). 284 "subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products. 285 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 286 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 287 "a_key": { # Specified details about taxation in a given geographical region. 288 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 289 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 290 }, 291 }, 292 }, 293 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days). 294}</pre> 295</div> 296 297<div class="method"> 298 <code class="details" id="list">list(packageName, maxResults=None, startIndex=None, token=None, x__xgafv=None)</code> 299 <pre>Lists all in-app products - both managed products and subscriptions. If an app has a large number of in-app products, the response may be paginated. In this case the response field `tokenPagination.nextPageToken` will be set and the caller should provide its value as a `token` request parameter to retrieve the next page. 300 301Args: 302 packageName: string, Package name of the app. (required) 303 maxResults: integer, Deprecated and ignored. The page size is determined by the server. 304 startIndex: integer, Deprecated and ignored. Set the `token` parameter to rertieve the next page. 305 token: string, Pagination token. If empty, list starts at the first product. 306 x__xgafv: string, V1 error format. 307 Allowed values 308 1 - v1 error format 309 2 - v2 error format 310 311Returns: 312 An object of the form: 313 314 { # Response listing all in-app products. 315 "inappproduct": [ # All in-app products. 316 { # An in-app product. The resource for InappproductsService. 317 "defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US". 318 "defaultPrice": { # Definition of a price, i.e. currency and units. # Default price. Cannot be zero, as in-app products are never free. Always in the developer's Checkout merchant currency. 319 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 320 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 321 }, 322 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. Allows developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values are P0D (zero days), P3D (three days), P7D (seven days), P14D (14 days), and P30D (30 days). 323 "listings": { # List of localized title and description data. Map key is the language of the localized data, as defined by BCP-47, e.g. "en-US". 324 "a_key": { # Store listing of a single in-app product. 325 "benefits": [ # Localized entitlement benefits for a subscription. 326 "A String", 327 ], 328 "description": "A String", # Description for the store listing. 329 "title": "A String", # Title for the store listing. 330 }, 331 }, 332 "managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products. 333 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 334 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 335 "a_key": { # Specified details about taxation in a given geographical region. 336 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 337 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 338 }, 339 }, 340 }, 341 "packageName": "A String", # Package name of the parent app. 342 "prices": { # Prices per buyer region. None of these can be zero, as in-app products are never free. Map key is region code, as defined by ISO 3166-2. 343 "a_key": { # Definition of a price, i.e. currency and units. 344 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 345 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 346 }, 347 }, 348 "purchaseType": "A String", # The type of the product, e.g. a recurring subscription. 349 "sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app. 350 "status": "A String", # The status of the product, e.g. whether it's active. 351 "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). 352 "subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products. 353 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 354 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 355 "a_key": { # Specified details about taxation in a given geographical region. 356 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 357 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 358 }, 359 }, 360 }, 361 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days). 362 }, 363 ], 364 "kind": "A String", # The kind of this response ("androidpublisher#inappproductsListResponse"). 365 "pageInfo": { # Information about the current page. List operations that supports paging return only one "page" of results. This protocol buffer message describes the page that has been returned. # Deprecated and unset. 366 "resultPerPage": 42, # Maximum number of results returned in one page. ! The number of results included in the API response. 367 "startIndex": 42, # Index of the first result returned in the current page. 368 "totalResults": 42, # Total number of results available on the backend ! The total number of results in the result set. 369 }, 370 "tokenPagination": { # Pagination information returned by a List operation when token pagination is enabled. List operations that supports paging return only one "page" of results. This protocol buffer message describes the page that has been returned. When using token pagination, clients should use the next/previous token to get another page of the result. The presence or absence of next/previous token indicates whether a next/previous page is available and provides a mean of accessing this page. ListRequest.page_token should be set to either next_page_token or previous_page_token to access another page. # Pagination token, to handle a number of products that is over one page. 371 "nextPageToken": "A String", # Tokens to pass to the standard list field 'page_token'. Whenever available, tokens are preferred over manipulating start_index. 372 "previousPageToken": "A String", 373 }, 374}</pre> 375</div> 376 377<div class="method"> 378 <code class="details" id="patch">patch(packageName, sku, autoConvertMissingPrices=None, body=None, x__xgafv=None)</code> 379 <pre>Patches an in-app product (i.e. a managed product or a subscriptions). 380 381Args: 382 packageName: string, Package name of the app. (required) 383 sku: string, Unique identifier for the in-app product. (required) 384 body: object, The request body. 385 The object takes the form of: 386 387{ # An in-app product. The resource for InappproductsService. 388 "defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US". 389 "defaultPrice": { # Definition of a price, i.e. currency and units. # Default price. Cannot be zero, as in-app products are never free. Always in the developer's Checkout merchant currency. 390 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 391 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 392 }, 393 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. Allows developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values are P0D (zero days), P3D (three days), P7D (seven days), P14D (14 days), and P30D (30 days). 394 "listings": { # List of localized title and description data. Map key is the language of the localized data, as defined by BCP-47, e.g. "en-US". 395 "a_key": { # Store listing of a single in-app product. 396 "benefits": [ # Localized entitlement benefits for a subscription. 397 "A String", 398 ], 399 "description": "A String", # Description for the store listing. 400 "title": "A String", # Title for the store listing. 401 }, 402 }, 403 "managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products. 404 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 405 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 406 "a_key": { # Specified details about taxation in a given geographical region. 407 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 408 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 409 }, 410 }, 411 }, 412 "packageName": "A String", # Package name of the parent app. 413 "prices": { # Prices per buyer region. None of these can be zero, as in-app products are never free. Map key is region code, as defined by ISO 3166-2. 414 "a_key": { # Definition of a price, i.e. currency and units. 415 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 416 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 417 }, 418 }, 419 "purchaseType": "A String", # The type of the product, e.g. a recurring subscription. 420 "sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app. 421 "status": "A String", # The status of the product, e.g. whether it's active. 422 "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). 423 "subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products. 424 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 425 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 426 "a_key": { # Specified details about taxation in a given geographical region. 427 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 428 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 429 }, 430 }, 431 }, 432 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days). 433} 434 435 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. 436 x__xgafv: string, V1 error format. 437 Allowed values 438 1 - v1 error format 439 2 - v2 error format 440 441Returns: 442 An object of the form: 443 444 { # An in-app product. The resource for InappproductsService. 445 "defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US". 446 "defaultPrice": { # Definition of a price, i.e. currency and units. # Default price. Cannot be zero, as in-app products are never free. Always in the developer's Checkout merchant currency. 447 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 448 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 449 }, 450 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. Allows developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values are P0D (zero days), P3D (three days), P7D (seven days), P14D (14 days), and P30D (30 days). 451 "listings": { # List of localized title and description data. Map key is the language of the localized data, as defined by BCP-47, e.g. "en-US". 452 "a_key": { # Store listing of a single in-app product. 453 "benefits": [ # Localized entitlement benefits for a subscription. 454 "A String", 455 ], 456 "description": "A String", # Description for the store listing. 457 "title": "A String", # Title for the store listing. 458 }, 459 }, 460 "managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products. 461 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 462 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 463 "a_key": { # Specified details about taxation in a given geographical region. 464 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 465 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 466 }, 467 }, 468 }, 469 "packageName": "A String", # Package name of the parent app. 470 "prices": { # Prices per buyer region. None of these can be zero, as in-app products are never free. Map key is region code, as defined by ISO 3166-2. 471 "a_key": { # Definition of a price, i.e. currency and units. 472 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 473 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 474 }, 475 }, 476 "purchaseType": "A String", # The type of the product, e.g. a recurring subscription. 477 "sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app. 478 "status": "A String", # The status of the product, e.g. whether it's active. 479 "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). 480 "subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products. 481 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 482 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 483 "a_key": { # Specified details about taxation in a given geographical region. 484 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 485 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 486 }, 487 }, 488 }, 489 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days). 490}</pre> 491</div> 492 493<div class="method"> 494 <code class="details" id="update">update(packageName, sku, allowMissing=None, autoConvertMissingPrices=None, body=None, x__xgafv=None)</code> 495 <pre>Updates an in-app product (i.e. a managed product or a subscriptions). 496 497Args: 498 packageName: string, Package name of the app. (required) 499 sku: string, Unique identifier for the in-app product. (required) 500 body: object, The request body. 501 The object takes the form of: 502 503{ # An in-app product. The resource for InappproductsService. 504 "defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US". 505 "defaultPrice": { # Definition of a price, i.e. currency and units. # Default price. Cannot be zero, as in-app products are never free. Always in the developer's Checkout merchant currency. 506 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 507 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 508 }, 509 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. Allows developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values are P0D (zero days), P3D (three days), P7D (seven days), P14D (14 days), and P30D (30 days). 510 "listings": { # List of localized title and description data. Map key is the language of the localized data, as defined by BCP-47, e.g. "en-US". 511 "a_key": { # Store listing of a single in-app product. 512 "benefits": [ # Localized entitlement benefits for a subscription. 513 "A String", 514 ], 515 "description": "A String", # Description for the store listing. 516 "title": "A String", # Title for the store listing. 517 }, 518 }, 519 "managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products. 520 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 521 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 522 "a_key": { # Specified details about taxation in a given geographical region. 523 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 524 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 525 }, 526 }, 527 }, 528 "packageName": "A String", # Package name of the parent app. 529 "prices": { # Prices per buyer region. None of these can be zero, as in-app products are never free. Map key is region code, as defined by ISO 3166-2. 530 "a_key": { # Definition of a price, i.e. currency and units. 531 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 532 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 533 }, 534 }, 535 "purchaseType": "A String", # The type of the product, e.g. a recurring subscription. 536 "sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app. 537 "status": "A String", # The status of the product, e.g. whether it's active. 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 "subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products. 540 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 541 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 542 "a_key": { # Specified details about taxation in a given geographical region. 543 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 544 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 545 }, 546 }, 547 }, 548 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days). 549} 550 551 allowMissing: boolean, If set to true, and the in-app product with the given package_name and sku doesn't exist, the in-app product will be created. 552 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. 553 x__xgafv: string, V1 error format. 554 Allowed values 555 1 - v1 error format 556 2 - v2 error format 557 558Returns: 559 An object of the form: 560 561 { # An in-app product. The resource for InappproductsService. 562 "defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US". 563 "defaultPrice": { # Definition of a price, i.e. currency and units. # Default price. Cannot be zero, as in-app products are never free. Always in the developer's Checkout merchant currency. 564 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 565 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 566 }, 567 "gracePeriod": "A String", # Grace period of the subscription, specified in ISO 8601 format. Allows developers to give their subscribers a grace period when the payment for the new recurrence period is declined. Acceptable values are P0D (zero days), P3D (three days), P7D (seven days), P14D (14 days), and P30D (30 days). 568 "listings": { # List of localized title and description data. Map key is the language of the localized data, as defined by BCP-47, e.g. "en-US". 569 "a_key": { # Store listing of a single in-app product. 570 "benefits": [ # Localized entitlement benefits for a subscription. 571 "A String", 572 ], 573 "description": "A String", # Description for the store listing. 574 "title": "A String", # Title for the store listing. 575 }, 576 }, 577 "managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products. 578 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 579 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 580 "a_key": { # Specified details about taxation in a given geographical region. 581 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 582 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 583 }, 584 }, 585 }, 586 "packageName": "A String", # Package name of the parent app. 587 "prices": { # Prices per buyer region. None of these can be zero, as in-app products are never free. Map key is region code, as defined by ISO 3166-2. 588 "a_key": { # Definition of a price, i.e. currency and units. 589 "currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java 590 "priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string. 591 }, 592 }, 593 "purchaseType": "A String", # The type of the product, e.g. a recurring subscription. 594 "sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app. 595 "status": "A String", # The status of the product, e.g. whether it's active. 596 "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). 597 "subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products. 598 "eeaWithdrawalRightType": "A String", # Digital content or service classification for products distributed to users in the European Economic Area (EEA). The withdrawal regime under EEA consumer laws depends on this classification. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information. 599 "taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR". 600 "a_key": { # Specified details about taxation in a given geographical region. 601 "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in United States. 602 "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498). 603 }, 604 }, 605 }, 606 "trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days). 607}</pre> 608</div> 609 610</body></html>