REST Resource: monetization.onetimeproducts.purchaseOptions.offers

Ресурс: OneTimeProductOffer

Единоразовое предложение на одноразовый продукт.

JSON-представление 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  },

  // Union field offer_type can be only one of the following:
  "preOrderOffer": {
    object (OneTimeProductPreOrderOffer)
  },
  "discountedOffer": {
    object (OneTimeProductDiscountedOffer)
  }
  // End of list of possible types for union field offer_type.
}
Поля
packageName

string

Обязательно. Неизменяемо. Имя пакета приложения, к которому принадлежит родительский продукт.

productId

string

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

purchaseOptionId

string

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

offerId

string

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

state

enum ( State )

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

regionalPricingAndAvailabilityConfigs[]

object ( RegionalPricingAndAvailabilityConfig )

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

offerTags[]

object ( OfferTag )

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

regionsVersion

object ( RegionsVersion )

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

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

object ( OneTimeProductPreOrderOffer )

Предложение по предварительному заказу.

discountedOffer

object ( OneTimeProductDiscountedOffer )

Предложение со скидкой.

Состояние

Текущее состояние предложения.

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

OneTimeProductPreOrderOffer

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

JSON-представление 
{
  "startTime": string,
  "endTime": string,
  "releaseTime": string,
  "priceChangeBehavior": enum (PreOrderPriceChangeBehavior)
}
Поля
startTime

string ( Timestamp format)

Обязательно. Время, когда предварительный заказ станет доступен.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

endTime

string ( Timestamp format)

Обязательно. Время, когда предварительный заказ станет недоступен.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

releaseTime

string ( Timestamp format)

Обязательно. Время, когда товар, связанный с предварительным заказом, будет выпущен, а предварительные заказы выполнены.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

priceChangeBehavior

enum ( PreOrderPriceChangeBehavior )

Обязательно. Неизменяемо. Указывает, как изменение цены влияет на уже существующие предварительные заказы.

PreOrderPriceChangeBehavior

Указывает, как изменение цены влияет на уже существующие предварительные заказы.

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

OneTimeProductDiscountedOffer

Конфигурация, специфичная для скидочных предложений.

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

string ( Timestamp format)

Время, когда предложение станет доступно.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

endTime

string ( Timestamp format)

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

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

redemptionLimit

string ( int64 format)

Необязательно. Укажите количество раз, которое можно использовать это предложение. Если не задано или равно 0, предложение можно использовать неограниченное количество раз. В противном случае необходимо указать число от 1 до 50 включительно.

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

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

JSON-представление 
{
  "regionCode": string,
  "availability": enum (Availability),

  // Union field price_override can be only one of the following:
  "noOverride": {
    object (OneTimeProductOfferNoPriceOverrideOptions)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  }
  // End of list of possible types for union field price_override.
}
Поля
regionCode

string

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

availability

enum ( Availability )

Обязательно. Доступность для этого региона.

Поле объединения price_override . Переопределение цены для этого предложения. Необходимо указать только одно значение. price_override может быть только одним из следующих:
noOverride

object ( OneTimeProductOfferNoPriceOverrideOptions )

Будет использована цена, указанная в варианте покупки для этого региона.

relativeDiscount

number

Доля цены опциона, которую пользователь платит за это предложение. Например, если цена опциона для этого региона составляет 12 долларов США, то скидка 50% будет соответствовать цене 6 долларов США. Скидка должна быть указана как дробь, строго больше 0 и строго меньше 1. Полученная цена будет округлена до ближайшей расчетной единицы (например, центов для долларов США). Относительная скидка считается недействительной, если цена со скидкой оказывается меньше минимально допустимой в этом регионе.

absoluteDiscount

object ( Money )

Абсолютное значение скидки, вычитаемое из цены опциона на покупку.

Он должен находиться в диапазоне от 0 до цены опциона на покупку.

Одноразовое предложение по продуктуБез ценыОшибки изменения

Этот тип не имеет полей.

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

Доступность

Наличие предложения.

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

Методы

activate

 Активирует одноразовое предложение продукта.

batchDelete

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

batchGet

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

batchUpdate

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

batchUpdateStates

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

cancel

 Отменяет одноразовое предложение продукта.

deactivate

 Деактивирует одноразовое предложение продукта.

list

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

Коды ошибок

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

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

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

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

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

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