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 символов.

OneTimeProductTaxAndComplianceSettings

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

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

object ( RegionalTaxConfig )

Региональная налоговая система.

isTokenizedDigitalAsset

boolean

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

productTaxCategoryCode

string

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

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 )

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

Узнать больше .

Вариант единовременной покупки товара

Вариант единовременной покупки товара.

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 для обеспечения обратной совместимости. В этом состоянии могут находиться только автоматически перенесенные варианты покупки.

OneTimeProductBuyPurchasOption

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

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 Изначально опция покупки недоступна, но станет доступна в рамках выпущенного предложения предварительного заказа.
AVAILABLE_FOR_OFFERS_ONLY Возможность покупки недоступна, но доступны связанные с ней предложения (например, предложение с бонусными баллами).

OneTimeProductPurchaseOptionNewRegionsConfig

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

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

object ( Money )

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

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 и метода purchases.products.acknowledge API разработчиков Play.

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