REST Resource: purchases.subscriptionsv2

{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}

string

Diese Art stellt ein SubscriptionPurchaseV2-Objekt im androidpublisher-Dienst dar.

string

ISO 3166-1 Alpha-2-Code für das Land/die Region der Rechnungsadresse des Nutzers zum Zeitpunkt der Abovergabe.

object (SubscriptionPurchaseLineItem)

Informationen auf Artikelebene für einen Abokauf. Die Elemente im selben Kauf sollten entweder alle mit AutoRenewingPlan oder alle mit PrepaidPlan sein.

string (Timestamp format)

Zeitpunkt, zu dem das Abo gewährt wurde. Nicht festgelegt für ausstehende Abos (Abo wurde erstellt, aber bei der Anmeldung wird auf die Zahlung gewartet).

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

enum (SubscriptionState)

Der aktuelle Status des Abos.

string

Die Bestell-ID der letzten Bestellung, die mit dem Kauf des Abos verknüpft ist. Bei einem Abonnement mit automatischer Verlängerung ist dies die Bestell-ID des Registrierungsauftrags, falls dieser noch nicht verlängert wurde, oder die letzte Dauerauftrags-ID (erfolgreich, ausstehend oder abgelehnt). Bei einem Prepaid-Abo ist dies die Bestell-ID, die dem abgefragten Kauftoken zugeordnet ist.

string

Das Kauftoken des alten Abos, wenn es sich um eines der folgenden Abos handelt: * Erneute Registrierung eines gekündigten, aber nicht abgelaufenen Abos * Upgrade/Downgrade von einem früheren Abo * Von Prepaid-Abo zu Abo mit automatischer Verlängerung wechseln. * Von einem Abo mit automatischer Verlängerung zu einem Prepaid-Tarif wechseln. * Prepaid-Abo aufladen.

object (PausedStateContext)

Zusätzlicher Kontext zu pausierten Abos. Nur vorhanden, wenn das Abo derzeit den Wert „subscriptionState“ SUBSCRIPTION_STATE_PAused hat.

object (CanceledStateContext)

Zusätzlicher Kontext zu gekündigten Abos Nur vorhanden, wenn das Abo derzeit das Abo „subscriptionState“ SUBSCRIPTION_STATE_CANCELED oder SUBSCRIPTION_STATE_EXPIRED hat.

object (TestPurchase)

Nur vorhanden, wenn es sich bei diesem Abokauf um einen Testkauf handelt.

enum (AcknowledgementState)

Der Bestätigungsstatus des Abos.

object (ExternalAccountIdentifiers)

ID des Nutzerkontos im Drittanbieterdienst.

object (SubscribeWithGoogleInfo)

Nutzerprofil, das mit Käufen verknüpft ist, die mit „Abonnieren mit Google“ getätigt wurden.

{
  "autoResumeTime": string
}

string (Timestamp format)

Zeitpunkt, zu dem das Abo automatisch fortgesetzt wird.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}

object (UserInitiatedCancellation)

Das Abo wurde vom Nutzer gekündigt.

object (SystemInitiatedCancellation)

Das Abo wurde vom System gekündigt, beispielsweise aufgrund eines Abrechnungsproblems.

object (DeveloperInitiatedCancellation)

Das Abo wurde vom Entwickler gekündigt.

object (ReplacementCancellation)

Das Abo wurde durch ein neues ersetzt.

{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}

object (CancelSurveyResult)

Informationen, die der Nutzer beim Abschließen der Kündigung des Abos bereitstellt (Umfrage zum Kündigungsgrund).

string (Timestamp format)

Der Zeitpunkt, zu dem das Abo vom Nutzer gekündigt wurde. Der Nutzer hat möglicherweise auch nach diesem Zeitraum Zugriff auf das Abo. Mit „lineItems.expiry_time“ lässt sich feststellen, ob ein Nutzer noch Zugriff hat.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}

enum (CancelSurveyReason)

Der Grund, den der Nutzer im Fragebogen zur Kündigung ausgewählt hat.

string

Nur festgelegt für CANCEL_SURVEY_REASON_OTHERS. Das ist die frei formulierte Antwort des Nutzers auf die Umfrage.

{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}

string

ID des Nutzerkontos im Drittanbieterdienst. Nur vorhanden, wenn die Kontoverknüpfung im Rahmen des Abokaufs erfolgt ist.

string

Eine verschleierte Version der ID, die dem Konto des Nutzers in Ihrer App eindeutig zugeordnet ist. Für folgende Käufe vorhanden: * Wenn die Kontoverknüpfung im Rahmen des Abokaufs erfolgt ist. * Sie wurde mit https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid beim Kauf angegeben.

string

Eine verschleierte Version der ID, die dem Profil des Nutzers in Ihrer App eindeutig zugeordnet ist. Wird nur angezeigt, wenn dies beim Kauf mit https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid angegeben wurde.

{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}

string

Die Google-Profil-ID des Nutzers beim Kauf des Abos.

string

Der Profilname des Nutzers beim Kauf des Abos.

string

Die E-Mail-Adresse des Nutzers beim Kauf des Abos.

string

Der Vorname des Nutzers beim Kauf des Abos.

string

Der Familienname des Nutzers beim Kauf des Abos.

{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
}

string

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

string (Timestamp format)

Zeitpunkt, zu dem das Abo abgelaufen ist oder abläuft, es sei denn, der Zugriff wird verlängert (z. B. verlängert).

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

object (AutoRenewingPlan)

Der Artikel wird automatisch verlängert.

object (PrepaidPlan)

Der Artikel ist im Voraus bezahlt.

object (OfferDetails)

Die Angebotsdetails für diesen Artikel.

object (DeferredItemReplacement)

Informationen zum Ersetzen verzögerter Artikel.

{
  "autoRenewEnabled": boolean,
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  }
}

boolean

Wenn für das Abo derzeit die automatische Verlängerung aktiviert ist, z.B. Der Nutzer hat das Abo nicht gekündigt.

object (SubscriptionItemPriceChangeDetails)

Die Informationen zur letzten Preisänderung für den Artikel seit der Registrierung des Abos.

object (InstallmentPlan)

Die Zusicherung für die Ratenzahlung und die Informationen zum Bundesstaat für den sich automatisch verlängernden Tarif.

{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}

object (Money)

Neuer wiederkehrender Preis für den Aboartikel.

enum (PriceChangeMode)

Der Preisänderungsmodus gibt an, wie sich der Preis des Aboartikels ändert.

enum (PriceChangeState)

Geben Sie den aktuellen Status der Preisänderung an.

string (Timestamp format)

Der Verlängerungszeitpunkt, zu dem die Preisänderung für den Nutzer in Kraft tritt. Dies kann sich(auf einen Zeitpunkt in der Zukunft) ändern, weil die Verlängerungszeit verschoben wird, z. B. eine Pause. Dieses Feld wird nur ausgefüllt, wenn die Preisänderung noch nicht in Kraft getreten ist.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}

integer

Gesamtzahl der Zahlungen, für die der Nutzer ursprünglich zugesichert ist.

integer

Die Gesamtzahl der Zahlungen, für die der Nutzer nach jedem Zusicherungszeitraum zustimmt. Leer bedeutet, dass der Ratenplan nach der anfänglichen Vereinbarung auf ein normales Abo mit automatischer Verlängerung zurückgesetzt wird.

integer

Gesamtzahl der noch zu begleichenden Zahlungen in diesem Verlängerungszeitraum.

object (PendingCancellation)

Falls vorhanden, steht die Kündigung dieses Ratenplans aus. Die Kündigung erfolgt erst, wenn der Nutzer alle zugesicherten Zahlungen abgeschlossen hat.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

Falls vorhanden, ist dies der Zeitraum, nach dem Aufladekäufe für den Prepaid-Tarif möglich sind. Ist bei abgelaufenen Prepaid-Tarifen nicht vorhanden.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}

string

Die neuesten Angebots-Tags, die mit dem Angebot verknüpft sind. Es enthält Tags, die aus dem Basis-Abo übernommen wurden.

string

Die ID des Basis-Abos. Vorhanden für alle Basis-Abos und Angebote.

string

Die Angebots-ID. Nur für vergünstigte Angebote vorhanden.

{
  "productId": string
}

string

Die productId, die die vorhandene productId ersetzt.