REST Resource: purchases.products

Ressource: ProductPurchase

Eine ProductPurchase-Ressource gibt den Status des Kaufs eines In-App-Produkts durch einen Nutzer 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 „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öglicher Wert: 0. Gekauft: 1 Abgebrochen 2. Ausstehend
consumptionState

integer

Der Nutzungsstatus des In-App-Produkts. Möglicher Wert: 0. Noch nicht verbraucht 1. Konsumiert:
developerPayload

string

Ein vom Entwickler angegebener String, der zusätzliche Informationen zu einer Bestellung enthält.
orderId

string

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

integer

Der Typ des Kaufs des In-App-Produkts. Dieses Feld wird nur festgelegt, wenn dieser Kauf nicht über den Standard-In-App-Abrechnungsablauf erfolgt ist. Möglicher Wert: 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öglicher Wert: 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 Abrechnungsregionscode nach ISO 3166-1 alpha-2 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 Beschreibung Auflösung