REST Resource: monetization.onetimeproducts

Ресурс: OneTimeProduct

Один товар, оплачиваемый однократно, для приложения.

JSON-представление 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
Поля
packageName

string

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

string

Обязательно. Не меняется. Уникальный идентификатор товара. Идентификатор товара должен быть уникальным в пределах родительского приложения. Он должен начинаться с цифры или строчной буквы и может содержать только цифры (0–9), строчные буквы (a–z), символы подчеркивания (_) и точки (.).
listings[]

object (OneTimeProductListing)

Обязательно. Набор локализованных названий и описаний. Не должно быть повторяющихся записей с одинаковым значением languageCode.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Сведения о налогах и соответствии юридическим и нормативным требованиям.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Обязательно. Набор способов покупки для этого контента, оплачиваемого однократно.
restrictedPaymentCountries

object (RestrictedPaymentCountries)

Необязательное поле. Страны, в которых для покупки этого контента, оплачиваемого однократно, можно использовать только способы оплаты, зарегистрированные в той же стране. Если поле не заполнено, ограничения не применяются.
offerTags[]

object (OfferTag)

Необязательное поле. Список, содержащий до 20 специальных тегов, указанных для этого контента для однократных покупок, и возвращаемых в приложение через библиотеку Платежей. Способы покупки и предложения для этого продукта также получат эти теги в библиотеке Платежей.
regionsVersion

object (RegionsVersion)

Только для вывода. Версия конфигурации регионов, которая использовалась для создания контента для однократных покупок.

OneTimeProductListing

Региональная страница приложения в Google Play для контента, оплачиваемого однократно.

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

string

Обязательно. Язык страницы приложения в Google Play, определенный по стандарту BCP-47, например "ru-RU".
title

string

Обязательно. Название товара на языке, который используется в этом предложении. Максимальная длина – 55 символов.
description

string

Обязательно. Описание товара на языке страницы. Максимальная длина – 200 символов.

OneTimeProductTaxAndComplianceSettings

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

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

object (RegionalTaxConfig)

Региональные налоговые настройки.
isTokenizedDigitalAsset

boolean

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

object (RegionalProductAgeRatingInfo)

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

string

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

RegionalTaxConfig

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

JSON-представление 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
Поля
regionCode

string

Обязательно. Код региона, к которому применяется эта конфигурация, в соответствии со стандартом ISO 3166-1 alpha-2, например "US".
taxTier

enum (TaxTier)

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

Подробнее…
eligibleForStreamingServiceTaxRate

boolean

Чтобы налог с продаж в США на местном уровне и уровне штата взимался правильно, необходимо указать, содержит ли приложение продукты, предназначенные для потоковой передачи данных. Поле поддерживается только в США.
streamingTaxType

enum (StreamingTaxType)

Чтобы учитывать налоги на услуги связи и развлечения на территории США, выберите подходящую категорию налогообложения.

Подробнее…

OneTimeProductPurchaseOption

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

JSON-представление 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of mutually exclusive fields.
}
Поля
purchaseOptionId

string

Обязательно. Не меняется. Уникальный идентификатор способа покупки. У каждого однократно оплачиваемого продукта должен быть уникальный идентификатор. Он должен начинаться с цифры или строчной буквы и может содержать только строчные буквы (a–z), цифры (0–9) и дефисы (-). Максимальная длина – 63 символа.
state

enum (State)

Только для вывода. Статус способа покупки, например "Активно". Это поле нельзя изменить, обновив ресурс. Используйте вместо них специальные конечные точки.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Информация о ценах и наличии товаров на уровне региона для этого способа покупки.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

Цены для новых регионов, в которых Google Play может начать работу в будущем. Если вы не укажете этот параметр, способ покупки не будет автоматически доступен в новых регионах, в которых Google Play может начать работу в будущем.
offerTags[]

object (OfferTag)

Необязательное поле. Список, содержащий до 20 специальных тегов, которые указаны для этого способа покупки и возвращаются в приложение через библиотеку Платежей. Предложения для этого способа покупки также получат эти теги в библиотеке Платежей.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

Необязательное поле. Сведения о налогах и соответствии юридическим и нормативным требованиям.
Тип варианта покупки. Нужно указать только одно значение. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
buyOption

object (OneTimeProductBuyPurchaseOption)

Вариант покупки, который можно приобрести.
rentOption

object (OneTimeProductRentPurchaseOption)

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

Штат

Текущий статус способа покупки.

Перечисления
STATE_UNSPECIFIED Значение по умолчанию, которое не должно использоваться.
DRAFT Способ покупки недоступен и никогда не был доступен пользователям.
ACTIVE Способ покупки доступен пользователям.
INACTIVE Этот способ покупки больше недоступен пользователям.
INACTIVE_PUBLISHED Вариант покупки больше недоступен, но мы продолжаем показывать его предложение через библиотеку Play Платежей для обратной совместимости. Этот статус могут иметь только автоматически перенесенные способы покупки.

OneTimeProductBuyPurchaseOption

Вариант покупки, который можно приобрести.

JSON-представление 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
Поля
legacyCompatible

boolean

Необязательное поле. Будет ли этот способ покупки доступен в устаревших процессах библиотеки Google Play Платежей, которые не поддерживают модель контента для однократных покупок.

Только один способ покупки типа "Купить" можно отметить как обратно совместимый.
multiQuantityEnabled

boolean

Необязательное поле. Разрешено ли покупать несколько единиц товара. Покупатели могут приобретать несколько товаров за один раз.

OneTimeProductRentPurchaseOption

Способ покупки, который можно взять напрокат.

JSON-представление 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
Поля
rentalPeriod

string

Обязательно. Период, в течение которого у пользователя есть право на доступ. Начинается после завершения процесса покупки. Указывается в формате ISO 8601.
expirationPeriod

string

Необязательное поле. Период времени, в течение которого пользователь может использовать разрешение, прежде чем оно будет отозвано. Указывается в формате ISO 8601.

RegionalPricingAndAvailabilityConfig

Настройка цен и наличия товаров на уровне региона для способа покупки.

JSON-представление 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
Поля
regionCode

string

Обязательно. Код региона, к которому применяется эта конфигурация, в соответствии со стандартом ISO 3166-1 alpha-2, например "RU".
price

object (Money)

Цена способа покупки в указанном регионе. Валюта должна соответствовать указанному региону.
availability

enum (Availability)

Доступность способа покупки.

Доступность

Доступность способа покупки.

Перечисления
AVAILABILITY_UNSPECIFIED Не указано наличие. Не используйте его.
AVAILABLE Способ покупки доступен пользователям.
NO_LONGER_AVAILABLE Способ покупки больше не доступен пользователям. Это значение можно использовать, только если ранее для доступности было задано значение AVAILABLE.
AVAILABLE_IF_RELEASED Способ покупки сначала недоступен, но становится доступен после публикации предложения с предзаказом.
AVAILABLE_FOR_OFFERS_ONLY Способ покупки недоступен, но связанные с ним предложения (например, Play Points) доступны.

OneTimeProductPurchaseOptionNewRegionsConfig

Цены для новых регионов, в которых Google Play может начать работу в будущем.

JSON-представление 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
Поля
usdPrice

object (Money)

Обязательно. Цена в долларах США, которая будет использоваться в новых регионах, где может быть запущен Google Play.
eurPrice

object (Money)

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

enum (Availability)

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

Доступность

Доступность новой конфигурации регионов.

Перечисления
AVAILABILITY_UNSPECIFIED Не указано наличие. Не используйте его.
AVAILABLE Эта конфигурация будет использоваться для всех новых регионов, которые могут появиться в Google Play в будущем.
NO_LONGER_AVAILABLE Конфигурация больше не доступна и не будет использоваться для новых регионов, которые могут появиться в Google Play. Это значение можно использовать, только если ранее для доступности было задано значение AVAILABLE.

PurchaseOptionTaxAndComplianceSettings

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

JSON-представление 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
Поля
withdrawalRightType

enum (WithdrawalRightType)

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

Если правило не настроено, по умолчанию используется значение WITHDRAWAL_RIGHT_DIGITAL_CONTENT.

Подробную информацию можно найти в статье Справочного центра.

Методы

batchDelete

 Удаляет один или несколько товаров, оплачиваемых однократно.

batchGet

 Чтение информации об одном или нескольких товарах, оплачиваемых однократно.

batchUpdate

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

delete

 Удаляет контент для однократных покупок.

get

 Чтение информации об определенном контенте для однократных покупок.

list

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

patch

 Создает или обновляет контент для однократных покупок.

Коды ошибок

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

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