REST Resource: purchases.products

Zasób: ProductPurchase

Zasób ProductPurchase wskazuje stan zakupu produktu w aplikacji przez użytkownika.

Zapis 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
}
Pola
kind

string

Ten rodzaj reprezentuje obiekt inappPurchase w usłudze androidpublisher.

purchaseTimeMillis

string (int64 format)

Czas zakupu produktu w milisekundach od epoki (1 stycznia 1970 r.).

purchaseState

integer

Stan zamówienia. Możliwe wartości: 0. Kupiono 1. Anulowano 2. Oczekuje

consumptionState

integer

Stan wykorzystania produktu w aplikacji. Możliwe wartości: 0. Jeszcze nie wykorzystane 1. Skonsumowano

developerPayload

string

Ciąg znaków określony przez dewelopera, który zawiera dodatkowe informacje o zamówieniu.

orderId

string

Identyfikator zamówienia powiązany z zakupem produktu w aplikacji.

purchaseType

integer

Typ zakupu produktu w aplikacji. To pole jest ustawione tylko wtedy, gdy zakup nie został dokonany za pomocą standardowego procesu płatności w aplikacji. Możliwe wartości: 0. Test (czyli zakupione z konta testowego licencji) 1. promocyjne (np. zakupione przy użyciu kodu promocyjnego). Nie obejmuje zakupów za punkty Play. 2. Nagroda (np. za obejrzenie reklamy wideo zamiast zapłaty)

acknowledgementState

integer

Stan potwierdzenia produktu w aplikacji. Możliwe wartości: 0. Jeszcze nie potwierdzone 1. Potwierdzono

purchaseToken

string

Token zakupu wygenerowany w celu identyfikacji tego zakupu. Może nie być obecna.

productId

string

Kod SKU produktu w aplikacji. Może nie być obecna.

quantity

integer

Ilość związana z zakupem produktu w aplikacji. Jeśli nie ma tej wartości, jest ona równa 1.

obfuscatedExternalAccountId

string

Zaszyfrowana wersja identyfikatora, który jest jednoznacznie powiązany z kontem użytkownika w aplikacji. Jest obecny tylko wtedy, gdy w momencie zakupu został podany za pomocą https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid.

obfuscatedExternalProfileId

string

Zaszyfrowana wersja identyfikatora, który jest jednoznacznie powiązany z profilem użytkownika w aplikacji. Jest obecny tylko wtedy, gdy w momencie dokonania zakupu został podany za pomocą metody https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid.

regionCode

string

Kod regionu rozliczeniowego użytkownika zgodny ze standardem ISO 3166-1 alfa-2 w momencie przyznania produktu.

refundableQuantity

integer

Ilość kwalifikująca się do zwrotu, czyli ilość, która nie została zwrócona. Wartość odzwierciedla częściowe zwroty środków za zamówienia z większą liczbą produktów oraz pełne zwroty środków.

Metody

acknowledge

potwierdza zakup produktu w aplikacji.

consume

zużycie zakupu produktu w aplikacji,

get

Sprawdzanie stanu zakupu i konsumpcji produktu w aplikacji.