REST Resource: purchases.productsv2

Ressource: ProductPurchaseV2

Eine ProductPurchaseV2-Ressource gibt den Status des 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 ein ProductPurchaseV2.
kind

string

Diese Art stellt ein ProductPurchaseV2-Objekt im androidpublisher-Dienst dar.
purchaseStateContext

object (PurchaseStateContext)

Informationen zum Kaufstatus.
testPurchaseContext

object (TestPurchaseContext)

Informationen zu Testkäufen Diese Einstellung wird nur für Testkäufe festgelegt.
orderId

string

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

string (Timestamp format)

Die Zeit, zu der der Kauf erfolgreich war, d.h., wenn sich der Kaufstatus in PURCHASED geändert hat. Dieses Feld ist erst nach Abschluss der Zahlung sichtbar. 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.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. 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 Kaufstatus nicht angegeben. Dieser Wert sollte niemals festgelegt werden.
PURCHASED Kauf abgeschlossen.
CANCELLED Kauf storniert.
PENDING Der Kauf befindet sich im Status „Ausstehend“ und wurde noch nicht abgeschlossen. Weitere Informationen zum Umgang mit ausstehenden Käufen 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 fop-Typ des Testkaufs.

FopType

Mögliche fop-Typen.

Enums
FOP_TYPE_UNSPECIFIED Fop-Typ nicht angegeben. Dieser Wert sollte niemals festgelegt werden.
TEST Der Kauf wurde mit einer Testkarte getätigt.

ProductLineItem

Enthält Informationen auf Artikelebene für ein 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

Angebotsdetails zu einer Kaufbuchung.

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. Es enthält 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)

Angebotsdetails zu Mietangeboten. Diese Option wird nur für Werbebuchungen für die Ausleihe festgelegt.
offerToken

string

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

integer

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

integer

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

enum (ConsumptionState)

Nur Ausgabe. Der Verbrauchsstatus des Kaufs.

RentOfferDetails

Dieser Typ hat keine Felder.

Angebotsdetails zu einer Werbebuchung für die Vermietung.

ConsumptionState

Mögliche Verbrauchsstatus

Enums
CONSUMPTION_STATE_UNSPECIFIED Verbrauchsstatus nicht angegeben. Dieser Wert sollte niemals festgelegt werden.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED Noch nicht in Anspruch genommen.
CONSUMPTION_STATE_CONSUMED Bereits aufgebraucht.

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.