Click here to see your recently viewed pages and most viewed pages.
Hide

Inappproducts

For a list of methods for this resource, see the end of this page.

Resource representations

{
  "packageName": string,
  "sku": string,
  "status": string,
  "purchaseType": string,
  "defaultPrice": {
    "priceMicros": string,
    "currency": string
  },
  "prices": {
    (key): {
      "priceMicros": string,
      "currency": string
    }
  },
  "listings": {
    (key): {
      "title": string,
      "description": string
    }
  },
  "defaultLanguage": string,
  "subscriptionPeriod": string,
  "season": {
    "start": {
      "month": unsigned integer,
      "day": unsigned integer
    },
    "end": {
      "month": unsigned integer,
      "day": unsigned integer
    }
  },
  "trialPeriod": string
}
Property name Value Description Notes
defaultLanguage string The default language of the localized data, specified with a BCP 47 language code. (For example, "en-US" for English as used in the U.S., "en-GB" for English as used in Great Britain, and so on.)
defaultPrice nested object Default price cannot be zero. In-app products can never be free. Default price is always in the developer's Checkout merchant currency.
defaultPrice.currency string 3 letter Currency code, as defined by ISO 4217.
defaultPrice.priceMicros string The price in millionths of the currency base unit represented as a string.
listings object List of localized title and description data.
listings.(key) nested object The language of the localized data, specified with a BCP 47 language code. (For example, "en-US" for English as used in the U.S., "en-GB" for English as used in Great Britain, and so on.)
listings.(key).description string
listings.(key).title string
packageName string The package name of the parent app.
prices object Prices per buyer region. None of these prices should be zero. In-app products can never be free.
prices.(key) nested object Key for the prices entry. This is a region code, specified in ISO 3166-2 format.
prices.(key).currency string 3 letter Currency code, as defined by ISO 4217.
prices.(key).priceMicros string The price in millionths of the currency base unit represented as a string.
purchaseType string Purchase type enum value. Unmodifiable after creation.

Acceptable values are:
  • "managedUser"
  • "subscription"
season nested object Definition of a season for a seasonal subscription. Can be defined only for yearly subscriptions.
season.end nested object Inclusive end date of the recurrence period.
season.end.day unsigned integer Day of a month, value in [1, 31] range. Valid range depends on the specified month.
season.end.month unsigned integer Month of a year. e.g. 1 = JAN, 2 = FEB etc.
season.start nested object Inclusive start date of the recurrence period.
season.start.day unsigned integer Day of a month, value in [1, 31] range. Valid range depends on the specified month.
season.start.month unsigned integer Month of a year. e.g. 1 = JAN, 2 = FEB etc.
sku string The stock-keeping-unit (SKU) of the product, unique within an app.
status string

Acceptable values are:
  • "active"
  • "inactive"
subscriptionPeriod string Subscription period, specified in ISO 8601 format. Acceptable values are "P1W" (one week), "P1M" (one month) and "P1Y" (one year).
trialPeriod string Trial period, specified in ISO 8601 format. Acceptable values are anything between "P7D" (seven days) and "P999D" (999 days). Seasonal subscriptions cannot have a trial period.

Methods

batch
delete
Delete an in-app product for an app.
get
Returns information about the in-app product specified.
insert
Creates a new in-app product for an app.
list
List all the in-app products for an Android app, both subscriptions and managed in-app products..
patch
Updates the details of an in-app product. This method supports patch semantics.
update
Updates the details of an in-app product.