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. 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 testowania 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 za płatność)
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 podczas zakupu został określony za pomocą https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid.
obfuscatedExternalProfileId

string

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

 Zużywa zakupiony produkt w aplikacji.

get

 Sprawdza stan zakupu i użycia produktu w aplikacji.

Kody błędów

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

Kod błędu Przyczyna Rozdzielczość
5xx Ogólny błąd serwera Google Play. Ponów żądanie.

Jeśli problem nie ustąpi, skontaktuj się z menedżerem konta Google Play lub prześlij prośbę o pomoc. Sprawdź panel stanu Google Play, aby dowiedzieć się, czy występują znane awarie.
409 Błąd aktualizacji współbieżnej.

Podjęto próbę zaktualizowania obiektu, który jest aktualizowany. Na przykład zakup jest potwierdzany przez jednoczesne wywołanie metody acknowledgePurchase() Biblioteki płatności w Play i metody purchases.products.acknowledge interfejsu Play Developer API.

 Ponów żądanie.