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 Checkout.
prices

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

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

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

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

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

Объект содержит список из нескольких пар ("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

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

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:

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