REST Resource: purchases.products

Ресурс: ProductPurchase

Ресурс 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

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

developerPayload

string

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

orderId

string

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

purchaseType

integer

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

acknowledgementState

integer

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

purchaseToken

string

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

productId

string

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

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:

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

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

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

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

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