REST Resource: purchases.productsv2

Ressource: ProductPurchaseV2

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

JSON-Darstellung 
{
  "productLineItem": [
    {
      object (ProductLineItem)
    }
  ],
  "kind": string,
  "purchaseStateContext": {
    object (PurchaseStateContext)
  },
  "testPurchaseContext": {
    object (TestPurchaseContext)
  },
  "orderId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "purchaseCompletionTime": string,
  "acknowledgementState": enum (AcknowledgementState)
}
Felder
productLineItem[]

object (ProductLineItem)

Enthält Informationen auf Artikelebene für einen ProductPurchaseV2.
kind

string

Dieser Typ stellt ein ProductPurchaseV2-Objekt im androidpublisher-Dienst dar.
purchaseStateContext

object (PurchaseStateContext)

Informationen zum Kaufstatus des Kaufs.
testPurchaseContext

object (TestPurchaseContext)

Informationen zu Testkäufen Dieser Wert wird nur für Testkäufe festgelegt.
orderId

string

Die Bestell-ID, die mit dem Kauf des In-App-Produkts verknüpft ist. Darf nicht festgelegt werden, wenn dem Kauf kein Auftrag zugeordnet ist.
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.
purchaseCompletionTime

string (Timestamp format)

Der Zeitpunkt, zu dem der Kauf erfolgreich war, d.h. zu dem sich der PurchaseState in PURCHASED geändert hat. Dieses Feld wird erst nach Abschluss der Zahlung angezeigt. Wenn der Nutzer beispielsweise eine ausstehende Transaktion (https://developer.android.com/google/play/billing/integrate#pending)) initiiert hat, wird dieses Feld erst ausgefüllt, wenn der Nutzer die erforderlichen Schritte zum Abschließen der Transaktion ausgeführt hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
acknowledgementState

enum (AcknowledgementState)

Nur Ausgabe. Der Bestätigungsstatus des Kaufs.

PurchaseStateContext

Kontext zum Kaufstatus.

JSON-Darstellung 
{
  "purchaseState": enum (PurchaseState)
}
Felder
purchaseState

enum (PurchaseState)

Nur Ausgabe. Der Kaufstatus des Kaufs.

PurchaseState

Mögliche Kaufstatus.

Enums
PURCHASE_STATE_UNSPECIFIED Der Kaufstatus ist nicht angegeben. Dieser Wert sollte nie festgelegt werden.
PURCHASED Erfolgreich gekauft.
CANCELLED Kauf storniert.
PENDING Der Kauf ist noch ausstehend und wurde noch nicht abgeschlossen. Weitere Informationen zum Verarbeiten ausstehender Käufe finden Sie unter https://developer.android.com/google/play/billing/integrate#pending.

TestPurchaseContext

Kontext zu einem Testkauf.

JSON-Darstellung 
{
  "fopType": enum (FopType)
}
Felder
fopType

enum (FopType)

Der Zahlungstyp des Testkaufs.

FopType

Mögliche FOP-Typen.

Enums
FOP_TYPE_UNSPECIFIED Zahlungsmitteltyp nicht angegeben. Dieser Wert sollte nie festgelegt werden.
TEST Der Kauf wurde mit einer Testkarte getätigt.

ProductLineItem

Enthält Informationen auf Artikelebene für einen ProductPurchaseV2.

JSON-Darstellung 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
Felder
productId

string

Die ID des gekauften Produkts, z. B. „monthly001“.
productOfferDetails

object (ProductOfferDetails)

Die Angebotsdetails für diesen Artikel.

ProductOfferDetails

Informationen zu Angebotsdetails für eine Kaufposition.

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

string

Die neuesten Angebots-Tags, die mit dem Angebot verknüpft sind. Dazu gehören Tags, die von der Kaufoption übernommen wurden.
offerId

string

Die Angebots-ID. Nur für Angebote vorhanden.
purchaseOptionId

string

Die Kaufoptions-ID.
rentOfferDetails

object (RentOfferDetails)

Details zu Mietangeboten Dieser Wert wird nur für Positionen mit Leihartikeln festgelegt.
offerToken

string

Das Angebotstoken pro Transaktion, das für diese Kaufposition verwendet wurde.
quantity

integer

Die Menge, die mit dem Kauf des In-App-Produkts verknüpft ist.
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.
consumptionState

enum (ConsumptionState)

Nur Ausgabe. Der Verbrauchsstatus des Kaufs.

RentOfferDetails

Dieser Typ hat keine Felder.

Informationen zu Angebotsdetails für eine Miet-Werbebuchung.

ConsumptionState

Mögliche Status für die Nutzung.

Enums
CONSUMPTION_STATE_UNSPECIFIED Der Verbrauchsstatus ist nicht angegeben. Dieser Wert sollte nie festgelegt werden.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED Noch nicht verbraucht.
CONSUMPTION_STATE_CONSUMED Bereits verwendet.

AcknowledgementState

Bestätigungsstatus des Einmalkaufprodukts.

Enums
ACKNOWLEDGEMENT_STATE_UNSPECIFIED Nicht angegebener Bestätigungsstatus.
ACKNOWLEDGEMENT_STATE_PENDING Der Kauf wurde noch nicht bestätigt.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED Der Kauf wird bestätigt.

Methoden

getproductpurchasev2

 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.