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

Dieser Typ stellt ein „inappPurchase“-Objekt im androidpublisher-Dienst dar.
purchaseTimeMillis

string (int64 format)

Der Zeitpunkt, zu dem das Produkt gekauft wurde, in Millisekunden seit der Epoche (1. Januar 1970).
purchaseState

integer

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

integer

Der Nutzungsstatus des In-App-Produkts. Mögliche Werte: 0. Noch nicht verbraucht 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 Kauf des In-App-Produkts. Dieses Feld wird nur festgelegt, wenn dieser Kauf nicht über den Standard-In-App-Abrechnungsablauf erfolgt ist. Mögliche Werte: 0. Test (d.h. über ein Lizenztestkonto gekauft) 1. Gutschein (d. h. mit einem Gutscheincode gekauft) Play Points-Käufe sind nicht enthalten. 2. Mit Prämie (d.h. durch Ansehen einer Videoanzeige anstelle einer Zahlung)
acknowledgementState

integer

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

string

Das Kauf-Token, das zur Identifizierung dieses Kaufs generiert wurde. Möglicherweise nicht vorhanden.
productId

string

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

integer

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

string

Eine verschleierte Version der ID, die eindeutig mit dem Konto des Nutzers in Ihrer App verknüpft 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. 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-Abrechnungsregionscode des Nutzers zum Zeitpunkt der Gewährung des Produkts.
refundableQuantity

integer

Die Menge, die für eine Erstattung infrage kommt, d.h. die Menge, die noch nicht erstattet wurde. Der Wert berücksichtigt mengenbasierte Teilerstattungen und vollständige Erstattungen.

Methoden

acknowledge

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

consume

 Verbraucht einen Kauf für einen In-App-Artikel.

get

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

Fehlercodes

Die Vorgänge dieser Ressource geben die folgenden HTTP-Fehlercodes zurück:

Fehlercode Grund Auflösung
5xx Allgemeiner Fehler auf dem Google Play-Server. Wiederholen Sie Ihre Anfrage.

Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Google Play-Kundenbetreuer oder senden Sie eine Supportanfrage. Prüfen Sie das Play-Status-Dashboard auf bekannte Ausfälle.
409 Fehler beim Aktualisieren der Gleichzeitigkeit.

Es wurde versucht, ein Objekt zu aktualisieren, das gerade aktualisiert wird. Beispiel: Ein Kauf wird bestätigt, indem gleichzeitig die Methode acknowledgePurchase() der Play Billing Library und die Methode purchases.products.acknowledge der Play Developer API aufgerufen werden.

 Wiederholen Sie Ihre Anfrage.