REST Resource: purchases.productsv2

Zasób: ProductPurchaseV2

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

Zapis 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)
}
Pola
productLineItem[]

object (ProductLineItem)

Zawiera informacje na poziomie produktu dla produktu ProductPurchaseV2.
kind

string

Ten typ reprezentuje obiekt ProductPurchaseV2 w usłudze androidpublisher.
purchaseStateContext

object (PurchaseStateContext)

Informacje o stanie zakupu.
testPurchaseContext

object (TestPurchaseContext)

informacje dotyczące zakupów testowych. Ta opcja będzie ustawiona tylko w przypadku zakupów testowych.
orderId

string

Identyfikator zamówienia powiązany z zakupem produktu w aplikacji. Nie może być ustawiony, jeśli z zakupem nie jest powiązane żadne zamówienie.
obfuscatedExternalAccountId

string

Zaszyfrowana wersja identyfikatora, który jest jednoznacznie powiązany z kontem użytkownika w aplikacji. Jest obecny tylko wtedy, gdy w momencie dokonania 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.
purchaseCompletionTime

string (Timestamp format)

Czas, w którym zakup został sfinalizowany, czyli gdy stan PurchaseState zmienił się na PURCHASED. To pole nie będzie widoczne, dopóki nie uregulujesz płatności. Jeśli na przykład użytkownik rozpoczął oczekiwaną transakcję (https://developer.android.com/google/play/billing/integrate#pending), to pole nie zostanie wypełnione, dopóki użytkownik nie wykona wszystkich czynności wymaganych do jej zrealizowania.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
acknowledgementState

enum (AcknowledgementState)

Tylko dane wyjściowe. Stan potwierdzenia zakupu.

PurchaseStateContext

kontekst dotyczący stanu zakupu;

Zapis JSON 
{
  "purchaseState": enum (PurchaseState)
}
Pola
purchaseState

enum (PurchaseState)

Tylko dane wyjściowe. Stan zakupu.

PurchaseState

Możliwe stany zakupu

Wartości w polu enum
PURCHASE_STATE_UNSPECIFIED Stan zakupu jest nieokreślony. Ta wartość nigdy nie powinna być ustawiana.
PURCHASED Zakup został sfinalizowany.
CANCELLED Zamówienie anulowane.
PENDING Zakup jest w stanie oczekiwania i nie został jeszcze zrealizowany. Więcej informacji o obsługiwaniu oczekujących zakupów znajdziesz na stronie https://developer.android.com/google/play/billing/integrate#pending.

TestPurchaseContext

Kontekst dotyczący testowego zakupu.

Zapis JSON 
{
  "fopType": enum (FopType)
}
Pola
fopType

enum (FopType)

Typ fop zakupu testowego.

FopType

Możliwe typy fop

Wartości w polu enum
FOP_TYPE_UNSPECIFIED Nieokreślony typ FOP. Ta wartość nigdy nie powinna być ustawiana.
TEST Zakup został dokonany za pomocą karty testowej.

ProductLineItem

Zawiera informacje na poziomie produktu dla produktu ProductPurchaseV2.

Zapis JSON 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
Pola
productId

string

Identyfikator zakupionego produktu (np. „monthly001”).
productOfferDetails

object (ProductOfferDetails)

Szczegóły oferty dotyczące tego produktu.

ProductOfferDetails

Szczegółowe informacje o ofercie dotyczące elementu zamówienia z zakupem.

Zapis JSON 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
Pola
offerTags[]

string

najnowsze tagi oferty powiązane z ofertą. Zawiera tagi odziedziczone z opcji zakupu.
offerId

string

Identyfikator oferty. Widoczne tylko w przypadku ofert.
purchaseOptionId

string

Identyfikator opcji zakupu.
rentOfferDetails

object (RentOfferDetails)

Szczegółowe informacje o ofertach wynajmu. Będzie ona ustawiana tylko w przypadku elementów linii wynajmu.
offerToken

string

Token oferty na transakcję użyty do tego elementu zamówienia zakupu.
quantity

integer

Ilość związana z zakupem produktu w aplikacji.
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.
consumptionState

enum (ConsumptionState)

Tylko dane wyjściowe. Stan wykorzystania zakupu.

RentOfferDetails

Ten typ nie ma pól.

Szczegółowe informacje o ofercie związanej z elementem zamówienia dotyczącym wynajmu.

ConsumptionState

Możliwe stany odtwarzania.

Wartości w polu enum
CONSUMPTION_STATE_UNSPECIFIED Stan zużycia nieokreślony. Ta wartość nigdy nie powinna być ustawiana.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED Nie zostały jeszcze wykorzystane.
CONSUMPTION_STATE_CONSUMED został już wykorzystany.

AcknowledgementState

Stan potwierdzenia produktu kupowanego raz.

Wartości w polu enum
ACKNOWLEDGEMENT_STATE_UNSPECIFIED Nieokreślony stan potwierdzenia.
ACKNOWLEDGEMENT_STATE_PENDING Zakup nie został jeszcze potwierdzony.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED Zakup został potwierdzony.

Metody

getproductpurchasev2

 Sprawdzanie stanu zakupu i konsumpcji produktu w aplikacji.