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 początku epoki (1 stycznia 1970 r.).
purchaseState

integer

Stan zakupu 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 zużyto 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

Rodzaj zakupu produktu w aplikacji. To pole jest ustawiane tylko wtedy, gdy zakup nie został dokonany przy użyciu standardowego procesu rozliczeń w aplikacji. Możliwe wartości: 0. Test (czyli zakupiona na koncie testowym licencji) 1. Promocyjna (czyli kupiona przy użyciu kodu promocyjnego). Nie obejmuje zakupów w ramach programu Play Points. 2. Nagrodzone (czyli uzyskane za obejrzenie reklamy wideo zamiast płacenia)
acknowledgementState

integer

Stan potwierdzenia produktu w aplikacji. Możliwe wartości: 0. Niepotwierdzone 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

Liczba powiązana z zakupem produktu w aplikacji. Jeśli nie jest obecna, ilość wynosi 1.
obfuscatedExternalAccountId

string

Zaciemniona wersja identyfikatora, który jest jednoznacznie powiązany z kontem użytkownika w Twojej aplikacji. Występuje tylko wtedy, gdy został określony za pomocą https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid podczas dokonywania zakupu.
obfuscatedExternalProfileId

string

Zaciemniona wersja identyfikatora, który jest jednoznacznie powiązany z profilem użytkownika w Twojej aplikacji. Występuje tylko wtedy, gdy został określony za pomocą parametru https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid podczas dokonywania zakupu.
regionCode

string

Kod regionu rozliczeniowego użytkownika w formacie ISO 3166-1 alfa-2 w momencie przyznania produktu.
refundableQuantity

integer

Liczba produktów kwalifikujących się do zwrotu, czyli liczba produktów, za które nie zwrócono jeszcze środków. Wartość odzwierciedla częściowe zwroty środków za zamówienia z większą liczbą produktów i pełne zwroty środków.

Metody

acknowledge

 Potwierdza zakup produktu w aplikacji.

consume

 Zrealizuj zakup produktu w aplikacji.

get

 Sprawdza stan zakupu i wykorzystania produktu w aplikacji.

Kody błędów

Operacje na tym zasobie zwracają te kody błędów HTTP:

Kod błędu Przyczyna Opis Rozdzielczość