/androidpublisher/v3/applications/{packageName}/inappproducts

Creates an in-app product (i.e. a managed product or a subscriptions).

curl --location --request POST 'https://androidpublisher.googleapis.com//androidpublisher/v3/applications//inappproducts' \ --header 'Content-Type: application/json' \ --data-raw '{ "defaultLanguage": "string", "defaultPrice": { "currency": "string", "priceMicros": "string" }, "gracePeriod": "string", "listings": { "property1": { "benefits": [ "string" ], "description": "string", "title": "string" }, "property2": { "benefits": [ "string" ], "description": "string", "title": "string" } }, "managedProductTaxesAndComplianceSettings": { "eeaWithdrawalRightType": "WITHDRAWAL_RIGHT_TYPE_UNSPECIFIED", "taxRateInfoByRegionCode": { "property1": { "eligibleForStreamingServiceTaxRate": true, "taxTier": "TAX_TIER_UNSPECIFIED" }, "property2": { "eligibleForStreamingServiceTaxRate": true, "taxTier": "TAX_TIER_UNSPECIFIED" } } }, "packageName": "string", "prices": { "property1": { "currency": "string", "priceMicros": "string" }, "property2": { "currency": "string", "priceMicros": "string" } }, "purchaseType": "purchaseTypeUnspecified", "sku": "string", "status": "statusUnspecified", "subscriptionPeriod": "string", "subscriptionTaxesAndComplianceSettings": { "eeaWithdrawalRightType": "WITHDRAWAL_RIGHT_TYPE_UNSPECIFIED", "taxRateInfoByRegionCode": { "property1": { "eligibleForStreamingServiceTaxRate": true, "taxTier": "TAX_TIER_UNSPECIFIED" }, "property2": { "eligibleForStreamingServiceTaxRate": true, "taxTier": "TAX_TIER_UNSPECIFIED" } } }, "trialPeriod": "string" }'

{ "defaultLanguage": "string", "defaultPrice": { "currency": "string", "priceMicros": "string" }, "gracePeriod": "string", "listings": { "property1": { "benefits": [ "string" ], "description": "string", "title": "string" }, "property2": { "benefits": [ "string" ], "description": "string", "title": "string" } }, "managedProductTaxesAndComplianceSettings": { "eeaWithdrawalRightType": "WITHDRAWAL_RIGHT_TYPE_UNSPECIFIED", "taxRateInfoByRegionCode": { "property1": { "eligibleForStreamingServiceTaxRate": true, "taxTier": "TAX_TIER_UNSPECIFIED" }, "property2": { "eligibleForStreamingServiceTaxRate": true, "taxTier": "TAX_TIER_UNSPECIFIED" } } }, "packageName": "string", "prices": { "property1": { "currency": "string", "priceMicros": "string" }, "property2": { "currency": "string", "priceMicros": "string" } }, "purchaseType": "purchaseTypeUnspecified", "sku": "string", "status": "statusUnspecified", "subscriptionPeriod": "string", "subscriptionTaxesAndComplianceSettings": { "eeaWithdrawalRightType": "WITHDRAWAL_RIGHT_TYPE_UNSPECIFIED", "taxRateInfoByRegionCode": { "property1": { "eligibleForStreamingServiceTaxRate": true, "taxTier": "TAX_TIER_UNSPECIFIED" }, "property2": { "eligibleForStreamingServiceTaxRate": true, "taxTier": "TAX_TIER_UNSPECIFIED" } } }, "trialPeriod": "string" }

Request

Path Params

packageName

string

required

Package name of the app.

Query Params

autoConvertMissingPrices

string

optional

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.

Body Params application/json

An in-app product. The resource for InappproductsService.

defaultLanguage

string

optional

Default language of the localized data, as defined by BCP-47. e.g. "en-US".

defaultPrice

object (Price)

optional

Default price. Cannot be zero, as in-app products are never free. Always in the developer's Checkout merchant currency.

currency

string

optional

3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java

priceMicros

string

optional

Price in 1/million of the currency base unit, represented as a string.

gracePeriod

string

optional

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

object

optional

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".

Additional properties

object (InAppProductListing)

optional

Store listing of a single in-app product.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

optional

Details about taxes and legal compliance. Only applicable to managed products.

eeaWithdrawalRightType

enum<string>

optional

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 for more information.

Allowed values:

WITHDRAWAL_RIGHT_TYPE_UNSPECIFIEDWITHDRAWAL_RIGHT_DIGITAL_CONTENTWITHDRAWAL_RIGHT_SERVICE

taxRateInfoByRegionCode

object

optional

A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".

packageName

string

optional

Package name of the parent app.

prices

object

optional

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.

Additional properties

object (Price)

optional

Definition of a price, i.e. currency and units.

purchaseType

enum<string>

optional

The type of the product, e.g. a recurring subscription.

Allowed values:

purchaseTypeUnspecifiedmanagedUsersubscription

sku

string

optional

Stock-keeping-unit (SKU) of the product, unique within an app.

status

enum<string>

optional

The status of the product, e.g. whether it's active.

Allowed values:

statusUnspecifiedactiveinactive

subscriptionPeriod

string

optional

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

object (SubscriptionTaxAndComplianceSettings)

optional

Details about taxes and legal compliance. Only applicable to subscription products.

eeaWithdrawalRightType

enum<string>

optional

Allowed values:

WITHDRAWAL_RIGHT_TYPE_UNSPECIFIEDWITHDRAWAL_RIGHT_DIGITAL_CONTENTWITHDRAWAL_RIGHT_SERVICE

taxRateInfoByRegionCode

object

optional

A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".

trialPeriod

string

optional

Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).

Examples

Responses

🟢200Successful response

application/json

Body

An in-app product. The resource for InappproductsService.

defaultLanguage

string

optional

Default language of the localized data, as defined by BCP-47. e.g. "en-US".

defaultPrice

object (Price)

optional

Default price. Cannot be zero, as in-app products are never free. Always in the developer's Checkout merchant currency.

currency

string

optional

3 letter Currency code, as defined by ISO 4217. See java/com/google/common/money/CurrencyCode.java

priceMicros

string

optional

Price in 1/million of the currency base unit, represented as a string.

gracePeriod

string

optional

listings

object

optional

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".

Additional properties

object (InAppProductListing)

optional

Store listing of a single in-app product.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

optional

Details about taxes and legal compliance. Only applicable to managed products.

eeaWithdrawalRightType

enum<string>

optional

Allowed values:

WITHDRAWAL_RIGHT_TYPE_UNSPECIFIEDWITHDRAWAL_RIGHT_DIGITAL_CONTENTWITHDRAWAL_RIGHT_SERVICE

taxRateInfoByRegionCode

object

optional

A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".

packageName

string

optional

Package name of the parent app.

prices

object

optional

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.

Additional properties

object (Price)

optional

Definition of a price, i.e. currency and units.

purchaseType

enum<string>

optional

The type of the product, e.g. a recurring subscription.

Allowed values:

purchaseTypeUnspecifiedmanagedUsersubscription

sku

string

optional

Stock-keeping-unit (SKU) of the product, unique within an app.

status

enum<string>

optional

The status of the product, e.g. whether it's active.

Allowed values:

statusUnspecifiedactiveinactive

subscriptionPeriod

string

optional

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

object (SubscriptionTaxAndComplianceSettings)

optional

Details about taxes and legal compliance. Only applicable to subscription products.

eeaWithdrawalRightType

enum<string>

optional

Allowed values:

WITHDRAWAL_RIGHT_TYPE_UNSPECIFIEDWITHDRAWAL_RIGHT_DIGITAL_CONTENTWITHDRAWAL_RIGHT_SERVICE

taxRateInfoByRegionCode

object

optional

A mapping from region code to tax rate details. The keys are region codes as defined by Unicode's "CLDR".

trialPeriod

string

optional

Trial period, specified in ISO 8601 format. Acceptable values are anything between P7D (seven days) and P999D (999 days).