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 )

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

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

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

ManagedProductTaxAndComplianceSettings

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

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

enum ( WithdrawalRightType )

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

taxRateInfoByRegionCode

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

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

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

isTokenizedDigitalAsset

boolean

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

productTaxCategoryCode

string

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

Методы

batchDelete

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

batchGet

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

batchUpdate

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

delete

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

get

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

insert

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

list

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

patch

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

update

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

коды ошибок

При работе с этим ресурсом возвращаются следующие коды ошибок HTTP:

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

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

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

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

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