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,

  // Union field TaxAndComplianceType can be only one of the following:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of list of possible types for union field TaxAndComplianceType.
}
Поля
packageName

string

Имя пакета родительского приложения.

sku

string

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

status

enum ( Status )

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

purchaseType

enum ( PurchaseType )

Тип продукта, например, повторяющаяся подписка.

defaultPrice

object ( Price )

Цена по умолчанию. Не может быть равна нулю, так как товары внутри приложения никогда не бывают бесплатными. Всегда указывается в валюте продавца 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, например, «en-US».

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

defaultLanguage

string

Язык локализованных данных по умолчанию, как определено в BCP-47, например, «en-US».

subscriptionPeriod

string

Период подписки, указанный в формате ISO 8601. Допустимые значения: P1W (одна неделя), P1M (один месяц), P3M (три месяца), P6M (шесть месяцев) и P1Y (один год).

trialPeriod

string

Пробный период, указанный в формате ISO 8601. Допустимые значения — от P7D (семь дней) до P999D (999 дней).

gracePeriod

string

Льготный период подписки, указанный в формате ISO 8601. Позволяет разработчикам предоставлять подписчикам льготный период в случае отклонения платежа за новый период повторения. Допустимые значения: P0D (ноль дней), P3D (три дня), P7D (семь дней), P14D (14 дней) и P30D (30 дней).

Поле объединения TaxAndComplianceType .

TaxAndComplianceType может быть только одним из следующих:

subscriptionTaxesAndComplianceSettings

object ( SubscriptionTaxAndComplianceSettings )

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

managedProductTaxesAndComplianceSettings

object ( ManagedProductTaxAndComplianceSettings )

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

Статус

Статус продукта внутри приложения.

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

ТипПокупки

Тип продукта.

Перечисления
purchaseTypeUnspecified Неуказанный тип покупки.
managedUser Тип товара по умолчанию — разовая покупка.
subscription Продукт внутри приложения с повторяющимся периодом.

InAppProductListing

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

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

string

Заголовок для листинга магазина.

description

string

Описание для листинга магазина.

benefits[]

string

Локализованные преимущества подписки.

Настройки налога на управляемый продукт и соответствия требованиям

Подробная информация о налогообложении и соблюдении законодательства в отношении управляемых продуктов.

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

enum ( WithdrawalRightType )

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

taxRateInfoByRegionCode

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

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

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

isTokenizedDigitalAsset

boolean

Заявлен ли этот продукт в приложении как продукт, представляющий собой токенизированный цифровой актив.

Методы

batchDelete

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

batchGet

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

batchUpdate

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

delete

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

get

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

insert

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

list

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

patch

 Исправляет ошибки внутриприкладного продукта (управляемого продукта или подписки).

update

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

Коды ошибок

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

Код ошибки Причина Разрешение
5xx Общая ошибка на сервере Google Play. Повторите запрос.

Если проблема не устранена, обратитесь к менеджеру своего аккаунта Google Play или отправьте запрос в службу поддержки. Рекомендуем проверить панель состояния Play на наличие известных сбоев.

409 Ошибка параллельного обновления.

Была попытка обновить обновляемый объект. Например, покупка подтверждается вызовом метода acknowledgePurchase() библиотеки Play Billing Library и одновременным вызовом метода purchases.products.acknowledge API Play Developer.

 Повторите запрос.