REST Resource: purchases.products

Ресурс: Покупка продукта

Ресурс ProductPurchase указывает статус покупки пользователем товара внутри приложения.

JSON-представление 
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
Поля
kind

string

Этот тип представляет собой объект inappPurchase в службе androidpublisher.

purchaseTimeMillis

string ( int64 format)

Время покупки товара в миллисекундах с начала эпохи (1 января 1970 г.).

purchaseState

integer

Статус покупки заказа. Возможные значения: 0. Куплено; 1. Отменено; 2. В ожидании.

consumptionState

integer

Состояние использования внутриигрового продукта. Возможные значения: 0 — ещё не использовано, 1 — использовано.

developerPayload

string

Строка, заданная разработчиком, содержащая дополнительную информацию о заказе.

orderId

string

Идентификатор заказа, связанный с покупкой внутриигрового продукта.

purchaseType

integer

Тип покупки внутриигрового продукта. Это поле заполняется только в том случае, если покупка была совершена не с использованием стандартного процесса оплаты внутри приложения. Возможные значения: 0. Тестовая версия (т.е. покупка с тестового аккаунта); 1. Промоверсия (т.е. покупка с использованием промокода). Не включает покупки в виде Play Points; 2. Версия с вознаграждением (т.е. за просмотр видеорекламы вместо оплаты).

acknowledgementState

integer

Состояние подтверждения для внутриигрового продукта. Возможные значения: 0 — ещё не подтверждено, 1 — подтверждено.

purchaseToken

string

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

productId

string

Артикул товара в приложении. Может отсутствовать.

quantity

integer

Количество, указанное при покупке внутриигрового продукта. Если значение отсутствует, то равно 1.

obfuscatedExternalAccountId

string

Зашифрованная версия идентификатора, уникально связанного с учетной записью пользователя в вашем приложении. Присутствует только в том случае, если указан с помощью https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid при совершении покупки.

obfuscatedExternalProfileId

string

Зашифрованная версия идентификатора, уникально связанного с профилем пользователя в вашем приложении. Присутствует только в том случае, если указан с помощью https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid при совершении покупки.

regionCode

string

Код региона выставления счетов ISO 3166-1 alpha-2 пользователя на момент предоставления продукта.

refundableQuantity

integer

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

Методы

acknowledge

 Подтверждает покупку внутриигрового товара.

consume

 Потребляет средства для покупки внутриигрового предмета.

get

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

коды ошибок

При работе с этим ресурсом возвращаются следующие коды ошибок HTTP:

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