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 wyrażony w milisekundach od początku epoki (1 stycznia 1970 r.).

purchaseState

integer

Stan zakupu zamówienia. Możliwe wartości to: 0. Zakupiono 1. Anulowane 2. Oczekuje

consumptionState

integer

Stan użycia produktu w aplikacji. Możliwe wartości to: 0. Nie do wykorzystania 1. Skonsumowano

developerPayload

string

Określony przez dewelopera ciąg tekstowy zawierający 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 ustawia się tylko wtedy, gdy zakupu nie dokonano za pomocą standardowego procesu rozliczeń w aplikacji. Możliwe wartości to: 0. Testowy (np. kupiony na koncie do testowania licencji) 1. promocja (np. zakup za pomocą kodu promocyjnego). Nie obejmuje zakupów punktów Play. 2. Z nagrodą (np. za obejrzenie reklamy wideo zamiast płatności)

acknowledgementState

integer

Stan potwierdzenia produktu w aplikacji. Możliwe wartości to: 0. 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 go nie ma, liczba to 1.

obfuscatedExternalAccountId

string

Zaciemniona wersja identyfikatora, który jest jednoznacznie powiązany z kontem użytkownika w Twojej aplikacji. Widoczny tylko wtedy, gdy podczas zakupu został określony za pomocą parametru 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. Widoczny 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 ISO 3166-1 alfa-2 użytkownika w momencie przyznania usługi.

refundableQuantity

integer

Ilość, która kwalifikuje się do zwrotu, tj. ilość, która nie została zwrócona. Wartość odzwierciedla częściowe zwroty środków za określoną liczbę produktów i pełne zwroty środków.

Metody

acknowledge

Potwierdza zakup produktu w aplikacji.

consume

Użytkownik kupuje produkt w aplikacji.

get

Sprawdza stan zakupu i wykorzystania produktu w aplikacji.