batchDelete(packageName, body=None, x__xgafv=None)
Deletes in-app products (managed products or subscriptions). Set the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput. This method should not be used to delete subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
batchGet(packageName, sku=None, x__xgafv=None)
Reads multiple in-app products, which can be managed products or subscriptions. This method should not be used to retrieve subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
batchUpdate(packageName, body=None, x__xgafv=None)
Updates or inserts one or more in-app products (managed products or subscriptions). Set the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput. This method should no longer be used to update subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Close httplib2 connections.
delete(packageName, sku, latencyTolerance=None, x__xgafv=None)
Deletes an in-app product (a managed product or a subscription). This method should no longer be used to delete subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
get(packageName, sku, x__xgafv=None)
Gets an in-app product, which can be a managed product or a subscription. This method should no longer be used to retrieve subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
insert(packageName, autoConvertMissingPrices=None, body=None, x__xgafv=None)
Creates an in-app product (a managed product or a subscription). This method should no longer be used to create subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
list(packageName, maxResults=None, startIndex=None, token=None, x__xgafv=None)
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. This method should no longer be used to retrieve subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Patches an in-app product (a managed product or a subscription). This method should no longer be used to update subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Updates an in-app product (a managed product or a subscription). This method should no longer be used to update subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
batchDelete(packageName, body=None, x__xgafv=None)
Deletes in-app products (managed products or subscriptions). Set the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput. This method should not be used to delete subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Args:
packageName: string, Package name of the app. (required)
body: object, The request body.
The object takes the form of:
{ # Request to delete multiple in-app products.
"requests": [ # Individual delete requests. At least one request is required. Can contain up to 100 requests. All requests must correspond to different in-app products.
{ # Request to delete an in-app product.
"latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.
"packageName": "A String", # Package name of the app.
"sku": "A String", # Unique identifier for the in-app product.
},
],
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
batchGet(packageName, sku=None, x__xgafv=None)
Reads multiple in-app products, which can be managed products or subscriptions. This method should not be used to retrieve subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Args:
packageName: string, Package name of the app. (required)
sku: string, Unique identifier for the in-app products. (repeated)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for BatchGetSubscriptions endpoint.
"inappproduct": [ # The list of requested in-app products, in the same order as the request.
{ # An in-app product. The resource for InappproductsService.
"defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US".
"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.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
"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).
"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".
"a_key": { # Store listing of a single in-app product.
"benefits": [ # Localized entitlement benefits for a subscription.
"A String",
],
"description": "A String", # Description for the store listing.
"title": "A String", # Title for the store listing.
},
},
"managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this in-app product is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"packageName": "A String", # Package name of the parent app.
"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.
"a_key": { # Definition of a price, i.e. currency and units.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
},
"purchaseType": "A String", # The type of the product, e.g. a recurring subscription.
"sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app.
"status": "A String", # The status of the product, e.g. whether it's active.
"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).
"subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this subscription is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).
},
],
}
batchUpdate(packageName, body=None, x__xgafv=None)
Updates or inserts one or more in-app products (managed products or subscriptions). Set the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput. This method should no longer be used to update subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Args:
packageName: string, Package name of the app. (required)
body: object, The request body.
The object takes the form of:
{ # Request to update or insert one or more in-app products.
"requests": [ # Required. Individual update requests. At least one request is required. Can contain up to 100 requests. All requests must correspond to different in-app products.
{ # Request to update an in-app product.
"allowMissing": True or False, # 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.
"autoConvertMissingPrices": True or False, # 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.
"inappproduct": { # An in-app product. The resource for InappproductsService. # The new in-app product.
"defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US".
"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.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
"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).
"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".
"a_key": { # Store listing of a single in-app product.
"benefits": [ # Localized entitlement benefits for a subscription.
"A String",
],
"description": "A String", # Description for the store listing.
"title": "A String", # Title for the store listing.
},
},
"managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this in-app product is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"packageName": "A String", # Package name of the parent app.
"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.
"a_key": { # Definition of a price, i.e. currency and units.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
},
"purchaseType": "A String", # The type of the product, e.g. a recurring subscription.
"sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app.
"status": "A String", # The status of the product, e.g. whether it's active.
"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).
"subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this subscription is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).
},
"latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.
"packageName": "A String", # Package name of the app.
"sku": "A String", # Unique identifier for the in-app product.
},
],
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response for a batch in-app product update.
"inappproducts": [ # The updated or inserted in-app products.
{ # An in-app product. The resource for InappproductsService.
"defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US".
"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.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
"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).
"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".
"a_key": { # Store listing of a single in-app product.
"benefits": [ # Localized entitlement benefits for a subscription.
"A String",
],
"description": "A String", # Description for the store listing.
"title": "A String", # Title for the store listing.
},
},
"managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this in-app product is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"packageName": "A String", # Package name of the parent app.
"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.
"a_key": { # Definition of a price, i.e. currency and units.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
},
"purchaseType": "A String", # The type of the product, e.g. a recurring subscription.
"sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app.
"status": "A String", # The status of the product, e.g. whether it's active.
"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).
"subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this subscription is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).
},
],
}
close()
Close httplib2 connections.
delete(packageName, sku, latencyTolerance=None, x__xgafv=None)
Deletes an in-app product (a managed product or a subscription). This method should no longer be used to delete subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Args:
packageName: string, Package name of the app. (required)
sku: string, Unique identifier for the in-app product. (required)
latencyTolerance: string, Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.
Allowed values
PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED - Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE - The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT - The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
get(packageName, sku, x__xgafv=None)
Gets an in-app product, which can be a managed product or a subscription. This method should no longer be used to retrieve subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Args:
packageName: string, Package name of the app. (required)
sku: string, Unique identifier for the in-app product. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An in-app product. The resource for InappproductsService.
"defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US".
"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.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
"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).
"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".
"a_key": { # Store listing of a single in-app product.
"benefits": [ # Localized entitlement benefits for a subscription.
"A String",
],
"description": "A String", # Description for the store listing.
"title": "A String", # Title for the store listing.
},
},
"managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this in-app product is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"packageName": "A String", # Package name of the parent app.
"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.
"a_key": { # Definition of a price, i.e. currency and units.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
},
"purchaseType": "A String", # The type of the product, e.g. a recurring subscription.
"sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app.
"status": "A String", # The status of the product, e.g. whether it's active.
"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).
"subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this subscription is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).
}
insert(packageName, autoConvertMissingPrices=None, body=None, x__xgafv=None)
Creates an in-app product (a managed product or a subscription). This method should no longer be used to create subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Args:
packageName: string, Package name of the app. (required)
body: object, The request body.
The object takes the form of:
{ # An in-app product. The resource for InappproductsService.
"defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US".
"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.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
"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).
"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".
"a_key": { # Store listing of a single in-app product.
"benefits": [ # Localized entitlement benefits for a subscription.
"A String",
],
"description": "A String", # Description for the store listing.
"title": "A String", # Title for the store listing.
},
},
"managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this in-app product is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"packageName": "A String", # Package name of the parent app.
"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.
"a_key": { # Definition of a price, i.e. currency and units.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
},
"purchaseType": "A String", # The type of the product, e.g. a recurring subscription.
"sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app.
"status": "A String", # The status of the product, e.g. whether it's active.
"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).
"subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this subscription is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).
}
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.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An in-app product. The resource for InappproductsService.
"defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US".
"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.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
"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).
"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".
"a_key": { # Store listing of a single in-app product.
"benefits": [ # Localized entitlement benefits for a subscription.
"A String",
],
"description": "A String", # Description for the store listing.
"title": "A String", # Title for the store listing.
},
},
"managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this in-app product is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"packageName": "A String", # Package name of the parent app.
"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.
"a_key": { # Definition of a price, i.e. currency and units.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
},
"purchaseType": "A String", # The type of the product, e.g. a recurring subscription.
"sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app.
"status": "A String", # The status of the product, e.g. whether it's active.
"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).
"subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this subscription is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).
}
list(packageName, maxResults=None, startIndex=None, token=None, x__xgafv=None)
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. This method should no longer be used to retrieve subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Args:
packageName: string, Package name of the app. (required)
maxResults: integer, Deprecated and ignored. The page size is determined by the server.
startIndex: integer, Deprecated and ignored. Set the `token` parameter to retrieve the next page.
token: string, Pagination token. If empty, list starts at the first product.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response listing all in-app products.
"inappproduct": [ # All in-app products.
{ # An in-app product. The resource for InappproductsService.
"defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US".
"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.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
"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).
"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".
"a_key": { # Store listing of a single in-app product.
"benefits": [ # Localized entitlement benefits for a subscription.
"A String",
],
"description": "A String", # Description for the store listing.
"title": "A String", # Title for the store listing.
},
},
"managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this in-app product is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"packageName": "A String", # Package name of the parent app.
"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.
"a_key": { # Definition of a price, i.e. currency and units.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
},
"purchaseType": "A String", # The type of the product, e.g. a recurring subscription.
"sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app.
"status": "A String", # The status of the product, e.g. whether it's active.
"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).
"subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this subscription is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).
},
],
"kind": "A String", # The kind of this response ("androidpublisher#inappproductsListResponse").
"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.
"resultPerPage": 42, # Maximum number of results returned in one page. ! The number of results included in the API response.
"startIndex": 42, # Index of the first result returned in the current page.
"totalResults": 42, # Total number of results available on the backend ! The total number of results in the result set.
},
"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.
"nextPageToken": "A String", # Tokens to pass to the standard list field 'page_token'. Whenever available, tokens are preferred over manipulating start_index.
"previousPageToken": "A String",
},
}
patch(packageName, sku, autoConvertMissingPrices=None, body=None, latencyTolerance=None, x__xgafv=None)
Patches an in-app product (a managed product or a subscription). This method should no longer be used to update subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Args:
packageName: string, Package name of the app. (required)
sku: string, Unique identifier for the in-app product. (required)
body: object, The request body.
The object takes the form of:
{ # An in-app product. The resource for InappproductsService.
"defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US".
"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.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
"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).
"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".
"a_key": { # Store listing of a single in-app product.
"benefits": [ # Localized entitlement benefits for a subscription.
"A String",
],
"description": "A String", # Description for the store listing.
"title": "A String", # Title for the store listing.
},
},
"managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this in-app product is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"packageName": "A String", # Package name of the parent app.
"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.
"a_key": { # Definition of a price, i.e. currency and units.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
},
"purchaseType": "A String", # The type of the product, e.g. a recurring subscription.
"sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app.
"status": "A String", # The status of the product, e.g. whether it's active.
"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).
"subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this subscription is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).
}
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.
latencyTolerance: string, Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.
Allowed values
PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED - Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE - The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT - The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An in-app product. The resource for InappproductsService.
"defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US".
"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.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
"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).
"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".
"a_key": { # Store listing of a single in-app product.
"benefits": [ # Localized entitlement benefits for a subscription.
"A String",
],
"description": "A String", # Description for the store listing.
"title": "A String", # Title for the store listing.
},
},
"managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this in-app product is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"packageName": "A String", # Package name of the parent app.
"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.
"a_key": { # Definition of a price, i.e. currency and units.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
},
"purchaseType": "A String", # The type of the product, e.g. a recurring subscription.
"sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app.
"status": "A String", # The status of the product, e.g. whether it's active.
"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).
"subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this subscription is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).
}
update(packageName, sku, allowMissing=None, autoConvertMissingPrices=None, body=None, latencyTolerance=None, x__xgafv=None)
Updates an in-app product (a managed product or a subscription). This method should no longer be used to update subscriptions. See [this article](https://android-developers.googleblog.com/2023/06/changes-to-google-play-developer-api-june-2023.html) for more information.
Args:
packageName: string, Package name of the app. (required)
sku: string, Unique identifier for the in-app product. (required)
body: object, The request body.
The object takes the form of:
{ # An in-app product. The resource for InappproductsService.
"defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US".
"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.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
"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).
"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".
"a_key": { # Store listing of a single in-app product.
"benefits": [ # Localized entitlement benefits for a subscription.
"A String",
],
"description": "A String", # Description for the store listing.
"title": "A String", # Title for the store listing.
},
},
"managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this in-app product is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"packageName": "A String", # Package name of the parent app.
"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.
"a_key": { # Definition of a price, i.e. currency and units.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
},
"purchaseType": "A String", # The type of the product, e.g. a recurring subscription.
"sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app.
"status": "A String", # The status of the product, e.g. whether it's active.
"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).
"subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this subscription is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).
}
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.
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.
latencyTolerance: string, Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.
Allowed values
PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED - Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE - The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.
PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT - The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An in-app product. The resource for InappproductsService.
"defaultLanguage": "A String", # Default language of the localized data, as defined by BCP-47. e.g. "en-US".
"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.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
"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).
"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".
"a_key": { # Store listing of a single in-app product.
"benefits": [ # Localized entitlement benefits for a subscription.
"A String",
],
"description": "A String", # Description for the store listing.
"title": "A String", # Title for the store listing.
},
},
"managedProductTaxesAndComplianceSettings": { # Details about taxation and legal compliance for managed products. # Details about taxes and legal compliance. Only applicable to managed products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this in-app product is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"packageName": "A String", # Package name of the parent app.
"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.
"a_key": { # Definition of a price, i.e. currency and units.
"currency": "A String", # 3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java
"priceMicros": "A String", # Price in 1/million of the currency base unit, represented as a string.
},
},
"purchaseType": "A String", # The type of the product, e.g. a recurring subscription.
"sku": "A String", # Stock-keeping-unit (SKU) of the product, unique within an app.
"status": "A String", # The status of the product, e.g. whether it's active.
"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).
"subscriptionTaxesAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for subscription products. # Details about taxes and legal compliance. Only applicable to subscription products.
"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.
"isTokenizedDigitalAsset": True or False, # Whether this subscription is declared as a product representing a tokenized digital asset.
"taxRateInfoByRegionCode": { # A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".
"a_key": { # Specified details about taxation in a given geographical region.
"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 the United States.
"streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
"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).
},
},
},
"trialPeriod": "A String", # Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).
}