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), строчные буквы (az), символы подчеркивания (_) и точки (.).

listings[]

object ( OneTimeProductListing )

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

taxAndComplianceSettings

object ( OneTimeProductTaxAndComplianceSettings )

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

purchaseOptions[]

object ( OneTimeProductPurchaseOption )

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

restrictedPaymentCountries

object ( RestrictedPaymentCountries )

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

offerTags[]

object ( OfferTag )

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

regionsVersion

object ( RegionsVersion )

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

OneTimeProductListing

Региональное размещение в магазине одноразового продукта.

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

string

Обязательно. Язык этого листинга, как определено в BCP-47, например, «en-US».

title

string

Обязательно. Название товара на языке, на котором он представлен. Максимальная длина — 55 символов.

description

string

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

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

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

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

object ( RegionalTaxConfig )

Региональная налоговая конфигурация.

isTokenizedDigitalAsset

boolean

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

RegionalTaxConfig

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

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

string

Обязательно. Код региона, к которому относится эта конфигурация, согласно ISO 3166-2, например, «США».

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)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
Поля
purchaseOptionId

string

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

state

enum ( State )

Только вывод. Состояние опции покупки, т. е. её активность. Это поле нельзя изменить путём обновления ресурса. Вместо этого используйте выделенные конечные точки.

regionalPricingAndAvailabilityConfigs[]

object ( RegionalPricingAndAvailabilityConfig )

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

newRegionsConfig

object ( OneTimeProductPurchaseOptionNewRegionsConfig )

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

offerTags[]

object ( OfferTag )

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

taxAndComplianceSettings

object ( PurchaseOptionTaxAndComplianceSettings )

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

Поле объединения purchase_option_type . Тип этого варианта покупки. Должен быть указан только один вариант. purchase_option_type может быть только одним из следующих:
buyOption

object ( OneTimeProductBuyPurchaseOption )

Опцион на покупку, который можно купить.

rentOption

object ( OneTimeProductRentPurchaseOption )

Возможность покупки с возможностью аренды.

Состояние

Текущее состояние возможности покупки.

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

OneTimeProductBuyPurchaseOption

Опцион на покупку, который можно купить.

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

boolean

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

До одного варианта покупки «купить» можно отметить как обратно совместимый.

multiQuantityEnabled

boolean

Необязательно. Позволяет ли этот вариант покупки выбрать несколько товаров. Возможность выбрать несколько товаров позволяет покупателю приобрести несколько товаров за один раз.

Одноразовая аренда/покупка продукта

Возможность покупки с возможностью аренды.

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

string

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

expirationPeriod

string

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

Региональные цены и доступность

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

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

string

Обязательно. Код региона, к которому относится эта конфигурация, согласно ISO 3166-2, например, «США».

price

object ( Money )

Цена опциона на покупку в указанном регионе. Должна быть указана в валюте, привязанной к указанному региону.

availability

enum ( Availability )

Наличие возможности покупки.

Доступность

Наличие возможности покупки.

Перечисления
AVAILABILITY_UNSPECIFIED Наличие не указано. Не подлежит использованию.
AVAILABLE Пользователям доступна возможность покупки.
NO_LONGER_AVAILABLE Возможность покупки больше недоступна пользователям. Это значение можно использовать только в том случае, если ранее было установлено значение «ДОСТУПНО».
AVAILABLE_IF_RELEASED Первоначально возможность покупки недоступна, но станет доступна через выпущенное предложение предварительного заказа.

OneTimeProductPurchaseOptionNewRegionsConfig

Информация о ценах для новых регионов, в которых Play может быть запущен в будущем.

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

object ( Money )

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

eurPrice

object ( Money )

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

availability

enum ( Availability )

Обязательно. Региональная доступность для конфигурации новых регионов. Если установлено значение «ДОСТУПНО», информация о ценах будет использоваться для любых новых регионов, в которых Play может быть запущен в будущем.

Доступность

Наличие новой конфигурации регионов.

Перечисления
AVAILABILITY_UNSPECIFIED Наличие не указано. Не подлежит использованию.
AVAILABLE Конфигурация будет использоваться для любых новых регионов, которые Play может запустить в будущем.
NO_LONGER_AVAILABLE Эта конфигурация больше недоступна и не будет использоваться для новых регионов, которые Play может запустить в будущем. Это значение можно использовать только в том случае, если ранее было установлено значение «ДОСТУПНО».

PurchaseOptionTaxAndComplianceSettings

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

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

enum ( WithdrawalRightType )

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

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

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

Методы

batchDelete

 Удаляет один или несколько одноразовых продуктов.

batchGet

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

batchUpdate

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

delete

 Удаляет одноразовый продукт.

get

 Считывает один одноразовый продукт.

list

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

patch

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

Коды ошибок

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

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

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

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

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

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