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

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

ManagedProductTaxAndComplianceSettings

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

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

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