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-Abrechnungsland-/Regionscode des Nutzers zum Zeitpunkt, als das Abo gewährt wurde.

object (SubscriptionPurchaseLineItem)

Informationen auf Artikelebene für einen Abokauf. Die Artikel 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 Abonnements (Abonnement wurde erstellt, wartet aber auf Zahlung während der Registrierung).

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 dem Kauf des Abos zugeordnet ist. Bei einem Abo mit automatischer Verlängerung ist dies die Bestell-ID der Registrierungsbestellung, falls diese noch nicht verlängert wurde, oder die letzte wiederkehrende Bestell-ID (erfolgreiche, ausstehende oder abgelehnte Bestellung). Bei einem Prepaid-Abo ist dies die Bestell-ID, die dem abgefragten Kauftoken zugeordnet ist.

string

Das Kauftoken des alten Abos, wenn dieses Abo eines der folgenden ist: * Erneute Registrierung eines gekündigten, aber nicht abgelaufenen Abos. * Upgrade/Downgrade eines früheren Abos. * Wechseln Sie von einem Prepaid-Abo zu einem Abo mit automatischer Verlängerung. * Von einem Abo mit automatischer Verlängerung zu einem Prepaid-Tarif wechseln * Laden Sie ein Prepaid-Abo auf.

object (PausedStateContext)

Zusätzlicher Kontext zu pausierten Abos. Ist nur vorhanden, wenn für das Abonnement zurzeit subscriptionState SUBSCRIPTION_STATE_PAUSED aufweist.

object (CanceledStateContext)

Weitere Informationen zu gekündigten Abos. Ist nur vorhanden, wenn für das Abonnement zurzeit subscriptionState SUBSCRIPTION_STATE_CANCELED oder SUBSCRIPTION_STATE_ wäre.

object (TestPurchase)

Nur vorhanden, wenn dieser Abokauf ein Testkauf ist.

enum (AcknowledgementState)

Der Bestätigungsstatus des Abos.

object (ExternalAccountIdentifiers)

Nutzerkonto-ID im Drittanbieterdienst.

object (SubscribeWithGoogleInfo)

Nutzerprofil, das mit Käufen über „Abonnieren mit Google“ verknüpft ist.

{
  "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 Abo ersetzt.

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

object (CancelSurveyResult)

Informationen, die der Nutzer bei der Kündigung des Abos angibt (Umfrage zu Kündigungsgründen).

string (Timestamp format)

Der Zeitpunkt, zu dem das Abo vom Nutzer gekündigt wurde. Der Nutzer hat nach dieser Zeit möglicherweise weiterhin Zugriff auf das Abo. Mit „lineItems.expiry_time“ können Sie 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 in der Umfrage zur Kündigung ausgewählt hat.

string

Nur für CANCEL_SURVEY_REASON_OTHERS festgelegt. Dies ist die freie Antwort des Nutzers bei der Umfrage.

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

string

Nutzerkonto-ID im Drittanbieterdienst. Nur vorhanden, wenn die Kontoverknüpfung im Rahmen des Abokaufs erfolgte.

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 beim Kauf mit https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid angegeben.

string

Eine verschleierte Version der ID, die eindeutig dem Nutzerprofil in Ihrer App zugeordnet ist. Ist nur vorhanden, 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, sofern der Zugriff nicht verlängert wird (z. B. Verlängerung).

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 verzögerten Austausch von Artikeln.

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

boolean

Wenn das Abo derzeit auf „Automatisch verlängern“ eingestellt ist, z.B. wenn der Nutzer es nicht gekündigt hat

object (SubscriptionItemPriceChangeDetails)

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

object (InstallmentPlan)

Die Zusicherung des Ratenplans und zustandsbezogene Informationen für den Tarif mit automatischer Verlängerung.

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

object (Money)

Neuer wiederkehrender Preis für das Abo.

enum (PriceChangeMode)

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

enum (PriceChangeState)

Aktueller Status der Preisänderung.

string (Timestamp format)

Der Verlängerungszeitpunkt, zu dem die Preisänderung für den Nutzer wirksam wird. Der Zeitpunkt kann sich noch ändern, wenn sich die Verlängerungszeit ändert, z. B. durch eine Pause. Dieses Feld wird nur gefüllt, wenn die Preisänderung noch nicht übernommen wurde.

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 zugesagt wurde.

integer

Gesamtzahl der Zahlungen, für die sich der Nutzer nach jedem Zusicherungszeitraum zusichert. Leer bedeutet, dass der Ratenplan nach der ursprünglichen Zusicherung auf ein normales Abo mit automatischer Verlängerung zurückgesetzt wird.

integer

Gesamtzahl der ausstehenden Zahlungen, die in diesem Verlängerungszyklus zu zahlen sind.

object (PendingCancellation)

Falls vorhanden, muss dieser Ratenplan demnächst gekündigt werden. Die Stornierung erfolgt erst, nachdem der Nutzer alle zugesicherten Zahlungen abgeschlossen hat.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

Falls vorhanden, ist dies der Zeitraum, nach dem das Aufladen für den Prepaid-Tarif möglich ist. 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 Basis-Abo-ID. Für alle Basis-Abos und Angebote vorhanden.

string

Die Angebots-ID. Kann nur für ermäßigte Angebote verwendet werden.

{
  "productId": string
}

string

Die productId, die die vorhandene productId ersetzt.