REST Resource: purchases.products

Ressource: ProductPurchase

Eine ProductPurchase-Ressource gibt den Status des In-App-Produktkaufs eines Nutzers an.

JSON-Darstellung
{
  "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
}
Felder
kind

string

Diese Art stellt ein In-App-Kaufobjekt im androidpublisher-Dienst dar.

purchaseTimeMillis

string (int64 format)

Zeitpunkt des Kaufs des Produkts in Millisekunden seit der Epoche (1. Januar 1970).

purchaseState

integer

Der Kaufstatus der Bestellung. Mögliche Werte: 0. 1 gekauft Abgebrochen 2. Ausstehend

consumptionState

integer

Der Verbrauchsstatus des In-App-Produkts. Mögliche Werte: 0. Noch nicht in Anspruch genommen 1. Konsumiert:

developerPayload

string

Ein vom Entwickler angegebener String mit zusätzlichen Informationen zu einer Bestellung.

orderId

string

Die Bestell-ID, die mit dem Kauf des In-App-Produkts verknüpft ist.

purchaseType

integer

Der Kauftyp des In-App-Produkts. Dieses Feld wird nur festgelegt, wenn der Kauf nicht über die standardmäßige In-App-Abrechnung erfolgt ist. Mögliche Werte: 0. Test (d.h. in einem Lizenztestkonto gekauft) 1. Aktionsartikel (d. h. mit einem Gutscheincode gekauft) Nicht enthalten sind Käufe mit Play Points. 2. Mit Prämie (d.h. durch das Ansehen einer Videoanzeige statt durch Zahlung)

acknowledgementState

integer

Der Bestätigungsstatus des In-App-Produkts. Mögliche Werte: 0. Noch nicht bestätigt 1. Bestätigt

purchaseToken

string

Das Kauftoken, das zur Identifizierung dieses Kaufs generiert wurde. Möglicherweise nicht vorhanden.

productId

string

Die SKU des In-App-Produkts. Möglicherweise nicht vorhanden.

quantity

integer

Die Menge, die mit dem Kauf des In-App-Produkts verknüpft ist. Wenn das Attribut nicht vorhanden ist, ist die Menge 1.

obfuscatedExternalAccountId

string

Eine verschleierte Version der ID, die eindeutig mit dem Konto des Nutzers in Ihrer App verknüpft ist. Diese ID ist nur vorhanden, wenn sie beim Kauf mit https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid angegeben wurde.

obfuscatedExternalProfileId

string

Eine verschleierte Version der ID, die eindeutig mit dem Profil des Nutzers in Ihrer App verknüpft ist. Diese ID ist nur vorhanden, wenn sie beim Kauf mit https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid angegeben wurde.

regionCode

string

Der ISO 3166-1 alpha-2-Rechnungsregionencode des Nutzers zum Zeitpunkt der Gewährung des Produkts.

refundableQuantity

integer

Die Menge, die erstattet werden kann, d.h. die Menge, die noch nicht erstattet wurde. Der Wert berücksichtigt mengenbasierte teilweise und vollständige Erstattungen.

Methoden

acknowledge

Bestätigt den Kauf eines In-App-Artikels.

consume

Es wird ein Kauf für einen In-App-Artikel konsumiert.

get

Prüft den Kauf- und Nutzungsstatus eines In-App-Artikels.