REST Resource: purchases.productsv2

Ресурс: ProductPurchaseV2

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

JSON-представление 
{
  "productLineItem": [
    {
      object (ProductLineItem)
    }
  ],
  "kind": string,
  "purchaseStateContext": {
    object (PurchaseStateContext)
  },
  "testPurchaseContext": {
    object (TestPurchaseContext)
  },
  "orderId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "purchaseCompletionTime": string,
  "acknowledgementState": enum (AcknowledgementState)
}
Поля
productLineItem[]

object ( ProductLineItem )

Содержит информацию на уровне элемента для ProductPurchaseV2.

kind

string

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

purchaseStateContext

object ( PurchaseStateContext )

Информация о состоянии покупки.

testPurchaseContext

object ( TestPurchaseContext )

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

orderId

string

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

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 на момент предоставления продукта.

purchaseCompletionTime

string ( Timestamp format)

Время, когда покупка была успешной, т. е. когда PurchaseState изменился на PURCHASED. Это поле не будет присутствовать, пока платеж не будет завершен. Например, если пользователь инициировал ожидающую транзакцию ( https://developer.android.com/google/play/billing/integrate#pending) , это поле не будет заполнено, пока пользователь успешно не выполнит шаги, необходимые для завершения транзакции.

Использует 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" .

acknowledgementState

enum ( AcknowledgementState )

Только вывод. Состояние подтверждения покупки.

PurchaseStateContext

Контекст о состоянии покупки.

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

enum ( PurchaseState )

Только вывод. Состояние покупки.

PurchaseState

Возможные состояния покупки.

Перечисления
PURCHASE_STATE_UNSPECIFIED Состояние покупки не указано. Это значение никогда не должно быть установлено.
PURCHASED Покупка прошла успешно.
CANCELLED Покупка отменена.
PENDING Покупка находится в состоянии ожидания и еще не завершена. Для получения дополнительной информации об обработке ожидающих покупок см. https://developer.android.com/google/play/billing/integrate#pending .

TestPurchaseContext

Контекст о тестовой закупке.

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

enum ( FopType )

Тип тестового закупа - щеголь.

FopType

Возможные типы щеголей.

Перечисления
FOP_TYPE_UNSPECIFIED Тип Fop не указан. Это значение никогда не должно быть установлено.
TEST Покупка была совершена с использованием тестовой карты.

ProductLineItem

Содержит информацию на уровне элемента для ProductPurchaseV2.

JSON-представление 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
Поля
productId

string

Идентификатор приобретенного продукта (например, «monthly001»).

productOfferDetails

object ( ProductOfferDetails )

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

ПродуктПредложениеПодробности

Подробная информация о предложении, связанная с позицией покупки.

JSON-представление 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
Поля
offerTags[]

string

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

offerId

string

Идентификатор предложения. Присутствует только для предложений.

purchaseOptionId

string

Идентификатор варианта покупки.

rentOfferDetails

object ( RentOfferDetails )

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

offerToken

string

Токен предложения на транзакцию, используемый для создания этой позиции покупки.

quantity

integer

Количество, связанное с покупкой продукта inapp.

refundableQuantity

integer

Количество, подлежащее возврату, т.е. количество, которое не было возвращено. Значение отражает частичные возвраты и полные возвраты на основе количества.

consumptionState

enum ( ConsumptionState )

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

АрендаПредложениеПодробности

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

Подробная информация о предложении, связанная с позицией аренды.

ПотреблениеСостояние

Возможные состояния потребления.

Перечисления
CONSUMPTION_STATE_UNSPECIFIED Состояние потребления не указано. Это значение никогда не должно быть установлено.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED Пока еще не потреблено.
CONSUMPTION_STATE_CONSUMED Уже потреблено.

ПодтверждениеСостояние

Состояние подтверждения одноразового продукта.

Перечисления
ACKNOWLEDGEMENT_STATE_UNSPECIFIED Неопределенное состояние подтверждения.
ACKNOWLEDGEMENT_STATE_PENDING Покупка пока не подтверждена.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED Покупка подтверждена.

Методы

getproductpurchasev2

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