REST Resource: inappproducts

Ресурс: InAppProduct

Контент, продаваемый через приложение. Ресурс для InappproductsService.

JSON-представление 
{
  "packageName": string,
  "sku": string,
  "status": enum (Status),
  "purchaseType": enum (PurchaseType),
  "defaultPrice": {
    object (Price)
  },
  "prices": {
    string: {
      object (Price)
    },
    ...
  },
  "listings": {
    string: {
      object (InAppProductListing)
    },
    ...
  },
  "defaultLanguage": string,
  "subscriptionPeriod": string,
  "trialPeriod": string,
  "gracePeriod": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of mutually exclusive fields.
}
Поля
packageName

string

Название пакета родительского приложения.
sku

string

Единица складского учета (SKU) товара, уникальная в пределах приложения.
status

enum (Status)

Статус товара, например "Активно".
purchaseType

enum (PurchaseType)

Тип продукта, например возобновляемая подписка.
defaultPrice

object (Price)

Цена по умолчанию. Не может быть нулевой, так как контент, продаваемый через приложение, не может быть бесплатным. Всегда в валюте продавца, указанной в Google Кошельке.
prices

map (key: string, value: object (Price))

Цены по регионам покупателей. Ни одно из этих значений не может быть равно нулю, так как контент в приложении не может быть бесплатным. Ключ карты – это код региона, определенный в стандарте ISO 3166-1 alpha-2.

Объект содержит список из нескольких пар ("key": value). Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
listings

map (key: string, value: object (InAppProductListing))

inappproducts.list локализованных названий и описаний. Ключ карты – это язык локализованных данных, определенный стандартом BCP-47, например "en-US".

Объект содержит список из нескольких пар ("key": value). Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultLanguage

string

Язык по умолчанию для локализованных данных, определенный в соответствии со стандартом BCP-47, например "ru-RU".
subscriptionPeriod
(deprecated)

string

Устарело: подписки больше не поддерживаются в InAppProducts API. Вместо него используйте Subscriptions API.
trialPeriod
(deprecated)

string

Устарело: подписки больше не поддерживаются в InAppProducts API. Вместо него используйте Subscriptions API.
gracePeriod
(deprecated)

string

Устарело: подписки больше не поддерживаются в InAppProducts API. Вместо него используйте Subscriptions API.
Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
subscriptionTaxesAndComplianceSettings
(deprecated)

object (SubscriptionTaxAndComplianceSettings)

Устарело: подписки больше не поддерживаются в InAppProducts API. Вместо него используйте Subscriptions API.
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Сведения о налогах и соблюдении юридических требований. Применимо только к управляемым продуктам.
Конец взаимоисключающих полей.

Статус

Статус контента, продаваемого через приложение.

Перечисления
statusUnspecified Статус не указан.
active Товар опубликован и активен в магазине.
inactive Товар не опубликован и поэтому неактивен в магазине.

PurchaseType

Тип товара.

Перечисления
purchaseTypeUnspecified Тип покупки не указан.
managedUser Тип товара по умолчанию – разовая покупка.
subscription

Устарело: подписки больше не поддерживаются в InAppProducts API. Вместо него используйте Subscriptions API.

InAppProductListing

Страница контента для продажи (через приложение) в Google Play.

JSON-представление 
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
Поля
title

string

Название страницы приложения в Google Play.
description

string

Описание для страницы приложения в Google Play.
benefits[]
(deprecated)

string

Устарело: подписки больше не поддерживаются в InAppProducts API. Вместо него используйте Subscriptions API.

ManagedProductTaxAndComplianceSettings

Информация о налогообложении и соответствии юридическим и нормативным требованиям для управляемого контента.

JSON-представление 
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
Поля
eeaWithdrawalRightType

enum (WithdrawalRightType)

Классификация цифрового контента или сервисов для продуктов, распространяемых среди пользователей в Европейской экономической зоне (ЕЭЗ). От выбранного варианта зависит, будет ли действовать право на отказ в соответствии с законами ЕЭЗ о защите прав потребителей. Подробную информацию можно найти в статье Справочного центра.
taxRateInfoByRegionCode

map (key: string, value: object (RegionalTaxRateInfo))

Сопоставление кода региона с информацией о налоговой ставке. Ключи – это коды регионов, определенные в CLDR Unicode.

Объект содержит список из нескольких пар ("key": value). Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
isTokenizedDigitalAsset

boolean

Указано ли, что этот контент, продаваемый через приложение, представляет собой токенизированный цифровой объект.
regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

Информация о возрастных ограничениях в разных регионах. В настоящее время это поле поддерживается только для кода региона US.
productTaxCategoryCode

string

Код категории налогообложения, который нужно назначить контенту для продажи через приложение. От категории налогообложения зависят применимые ставки налога на транзакции. Подробную информацию можно найти в статье Справочного центра.

Методы

batchDelete

 Удаляет контент, продаваемый через приложение (управляемые товары или подписки).

batchGet

 Считывает данные о нескольких товарах, которые могут быть подписками или ограниченным контентом.

batchUpdate

 Обновляет или вставляет один или несколько товаров, продаваемых через приложение (управляемые товары или подписки).

delete

 Удаляет контент, продаваемый через приложение (подписку или управляемый товар).

get

 Получает контент, продаваемый через приложение, который может быть управляемым товаром или подпиской.

insert

 Создает контент для продажи через приложение (управляемый товар или подписку).

list

 Список всех товаров, продаваемых через приложение, включая управляемый контент и подписки.

patch

 Обновляет контент, продаваемый через приложение (ограниченный контент или подписку).

update

 Обновляет контент, продаваемый через приложение (подписку или управляемый товар).

Коды ошибок

Операции этого ресурса возвращают следующие коды ошибок HTTP:

Код ошибки Причина Описание Разрешение