REST Resource: purchases.subscriptionsv2

Ressource: SubscriptionPurchaseV2

Gibt den Status des Abokaufs eines Nutzers an.

JSON-Darstellung
{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  },
  "etag": string,
  "outOfAppPurchaseContext": {
    object (OutOfAppPurchaseContext)
  },
  "onHoldStateContext": {
    object (OnHoldStateContext)
  },
  "inGracePeriodStateContext": {
    object (InGracePeriodStateContext)
  }
}
Felder
kind

string

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

regionCode

string

ISO 3166-1 Alpha-2-Ländercode des Landes der Rechnungsadresse des Nutzers zum Zeitpunkt der Gewährung des Abos.

lineItems[]

object (SubscriptionPurchaseLineItem)

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

startTime

string (Timestamp format)

Zeitpunkt, zu dem das Abo gewährt wurde. Nicht festgelegt für ausstehende Abos (Abo wurde erstellt, aber die Zahlung während der Registrierung steht noch aus).

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".

subscriptionState

enum (SubscriptionState)

Der aktuelle Status des Abos.

linkedPurchaseToken

string

Das Kauf-Token des alten Abos, wenn dieses Abo eines der folgenden ist: * Erneute Anmeldung für ein gekündigtes, aber nicht abgelaufenes Abo * Upgrade/Downgrade von einem vorherigen Abo. * Prepaid-Tarif in ein Abo mit automatischer Verlängerung umwandeln. * Von einem Abo mit automatischer Verlängerung zu einem Prepaid-Tarif wechseln * Prepaid-Abo aufladen

pausedStateContext

object (PausedStateContext)

Zusätzlicher Kontext zu pausierten Abos. Wird nur angezeigt, wenn das Abo derzeit den Status „subscriptionState“ „SUBSCRIPTION_STATE_PAUSED“ hat.

canceledStateContext

object (CanceledStateContext)

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

testPurchase

object (TestPurchase)

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

acknowledgementState

enum (AcknowledgementState)

Der Bestätigungsstatus des Abos.

externalAccountIdentifiers

object (ExternalAccountIdentifiers)

Nutzerkonto-ID im Drittanbieterdienst.

subscribeWithGoogleInfo

object (SubscribeWithGoogleInfo)

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

etag

string

Entitäts-Tag, das den aktuellen Status des Abos darstellt. Der Entwickler stellt dieses ETag für Aboaktionen bereit. Dieses ETag ist für Abos mit automatischer Verlängerung und Prepaid-Abos immer vorhanden.

outOfAppPurchaseContext

object (OutOfAppPurchaseContext)

Zusätzlicher Kontext für Out-of-App-Käufe. Diese Informationen sind nur für Käufe von Neuabos verfügbar, die über das Google Play-Abo-Center abgeschlossen wurden. Neuabos sind Abos, die abgeschlossen werden, nachdem das vorherige Abo desselben Produkts abgelaufen ist. Dieses Feld wird entfernt, nachdem Sie das Abo bestätigt haben.

onHoldStateContext

object (OnHoldStateContext)

Optional. Zusätzlicher Kontext zu Abos im Status ON_HOLD. Wird nur angezeigt, wenn das Abo derzeit den Status „SUBSCRIPTION_STATE_ON_HOLD“ hat.

inGracePeriodStateContext

object (InGracePeriodStateContext)

Optional. Zusätzlicher Kontext zu Abos im Status IN_GRACE_PERIOD. Nur vorhanden, wenn das Abo derzeit den Status „subscriptionState“ „SUBSCRIPTION_STATE_IN_GRACE_PERIOD“ hat.

SubscriptionState

Die möglichen Status eines Abos, z. B. ob es aktiv oder gekündigt ist. Die Artikel in einem Abo können entweder alle automatisch verlängert werden oder Prepaid-Tarife sein.

Enums
SUBSCRIPTION_STATE_UNSPECIFIED Nicht angegebener Abostatus.
SUBSCRIPTION_STATE_PENDING Das Abo wurde erstellt, aber die Zahlung steht noch aus. In diesem Status wird für alle Artikel auf die Zahlung gewartet.
SUBSCRIPTION_STATE_ACTIVE Abonnement ist aktiv. – (1) Wenn es sich um ein sich automatisch verlängerndes Abo handelt, ist mindestens ein Artikel „autoRenewEnabled“ und nicht abgelaufen. – (2) Wenn es sich bei dem Abo um einen Prepaid-Tarif handelt, ist mindestens ein Artikel nicht abgelaufen.
SUBSCRIPTION_STATE_PAUSED Das Abo ist pausiert. Der Status ist nur verfügbar, wenn es sich bei dem Abo um ein sich automatisch verlängerndes Abo handelt. In diesem Status sind alle Elemente pausiert.
SUBSCRIPTION_STATE_IN_GRACE_PERIOD Das Abo befindet sich im Kulanzzeitraum. Der Status ist nur verfügbar, wenn es sich bei dem Abo um ein sich automatisch verlängerndes Abo handelt. In diesem Status befinden sich alle Elemente im Kulanzzeitraum.
SUBSCRIPTION_STATE_ON_HOLD Das Abo ist gesperrt. Der Status ist nur verfügbar, wenn es sich bei dem Abo um ein sich automatisch verlängerndes Abo handelt. In diesem Status sind alle Elemente auf „Hold“.
SUBSCRIPTION_STATE_CANCELED Das Abo wurde gekündigt, ist aber noch nicht abgelaufen. Der Status ist nur verfügbar, wenn es sich bei dem Abo um ein sich automatisch verlängerndes Abo handelt. Bei allen Artikeln ist „autoRenewEnabled“ auf „false“ gesetzt.
SUBSCRIPTION_STATE_EXPIRED Das Abo ist abgelaufen. Alle Elemente haben ein Ablaufdatum in der Vergangenheit.
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED Die ausstehende Transaktion für das Abo wurde storniert. Wenn dieser ausstehende Kauf für ein bestehendes Abo war, verwende „linkedPurchaseToken“, um den aktuellen Status dieses Abos abzurufen.

PausedStateContext

Informationen zu einem Abo im Status „Pausiert“.

JSON-Darstellung
{
  "autoResumeTime": string
}
Felder
autoResumeTime

string (Timestamp format)

Zeitpunkt, zu dem das Abo automatisch fortgesetzt wird.

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".

CanceledStateContext

Spezifische Informationen zu einem Abo im Status SUBSCRIPTION_STATE_CANCELED oder SUBSCRIPTION_STATE_EXPIRED.

JSON-Darstellung
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of mutually exclusive fields.
}
Felder
Der Grund, warum ein Abo gekündigt wurde. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
userInitiatedCancellation

object (UserInitiatedCancellation)

Das Abo wurde vom Nutzer gekündigt.

systemInitiatedCancellation

object (SystemInitiatedCancellation)

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

developerInitiatedCancellation

object (DeveloperInitiatedCancellation)

Das Abo wurde vom Entwickler gekündigt.

replacementCancellation

object (ReplacementCancellation)

Das Abo wurde durch ein neues Abo ersetzt.

Ende der sich gegenseitig ausschließenden Felder.

UserInitiatedCancellation

Informationen zu Stornierungen, die von Nutzern initiiert wurden.

JSON-Darstellung
{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}
Felder
cancelSurveyResult

object (CancelSurveyResult)

Informationen, die der Nutzer beim Kündigen des Abos angibt (Umfrage zum Kündigungsgrund).

cancelTime

string (Timestamp format)

Der Zeitpunkt, zu dem das Abo vom Nutzer gekündigt wurde. Der Nutzer hat möglicherweise auch nach diesem Zeitpunkt noch Zugriff auf das Abo. Mit lineItems.expiry_time können Sie feststellen, ob ein Nutzer noch Zugriff 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".

CancelSurveyResult

Ergebnis der Umfrage zur Kündigung, wenn das Abo vom Nutzer gekündigt wurde.

JSON-Darstellung
{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}
Felder
reason

enum (CancelSurveyReason)

Der Grund, den der Nutzer in der Umfrage zur Kündigung ausgewählt hat.

reasonUserInput

string

Wird nur für CANCEL_SURVEY_REASON_OTHERS festgelegt. Dies ist die Freiformantwort des Nutzers auf die Umfrage.

CancelSurveyReason

Der Grund, den der Nutzer in der Umfrage zur Kündigung ausgewählt hat.

Enums
CANCEL_SURVEY_REASON_UNSPECIFIED Nicht angegebener Grund für den Abbruch der Umfrage.
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE Das Abo wird nicht ausreichend genutzt.
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES Technische Probleme bei der Nutzung der App.
CANCEL_SURVEY_REASON_FOUND_BETTER_APP Der Nutzer hat eine bessere App gefunden.
CANCEL_SURVEY_REASON_OTHERS Sonstige Gründe

SystemInitiatedCancellation

Dieser Typ hat keine Felder.

Informationen zu Stornierungen, die vom Google-System initiiert wurden.

DeveloperInitiatedCancellation

Dieser Typ hat keine Felder.

Informationen zu Kündigungen, die von Entwicklern initiiert wurden.

ReplacementCancellation

Dieser Typ hat keine Felder.

Informationen zu Kündigungen, die durch einen Aboersatz verursacht wurden.

TestPurchase

Dieser Typ hat keine Felder.

Gibt an, ob dieser Abokauf ein Testkauf ist.

AcknowledgementState

Die möglichen Bestätigungsstatus für ein Abo.

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

ExternalAccountIdentifiers

Nutzerkonto-ID im Drittanbieterdienst.

JSON-Darstellung
{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}
Felder
externalAccountId

string

Nutzerkonto-ID im Drittanbieterdienst. Nur vorhanden, wenn die Kontoverknüpfung im Rahmen des Abo-Kaufvorgangs erfolgt ist.

obfuscatedExternalAccountId

string

Eine verschleierte Version der ID, die eindeutig mit dem Konto des Nutzers in deiner App verknüpft ist. Vorhanden für die folgenden Käufe: * Wenn die Kontoverknüpfung im Rahmen des Kaufvorgangs für das Abo erfolgt ist. * Sie wurde beim Kauf mit https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid angegeben.

obfuscatedExternalProfileId

string

Eine verschleierte Version der ID, die eindeutig mit dem Profil des Nutzers in deiner App verknüpft ist. Nur vorhanden, wenn beim Kauf https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid angegeben wurde.

SubscribeWithGoogleInfo

Informationen zu Käufen, die mit „Abonnieren mit Google“ getätigt wurden.

JSON-Darstellung
{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}
Felder
profileId

string

Die Google-Profil-ID des Nutzers, als das Abo gekauft wurde.

profileName

string

Der Profilname des Nutzers, als das Abo gekauft wurde.

emailAddress

string

Die E-Mail-Adresse des Nutzers, die beim Kauf des Abos verwendet wurde.

givenName

string

Der Vorname des Nutzers beim Kauf des Abos.

familyName

string

Der Nachname des Nutzers, als das Abo gekauft wurde.

SubscriptionPurchaseLineItem

Informationen auf Artikelebene für einen Abokauf.

JSON-Darstellung
{
  "productId": string,
  "expiryTime": string,
  "developerTargetedOffers": [
    {
      object (DeveloperTargetedOffer)
    }
  ],
  "latestSuccessfulOrderId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of mutually exclusive fields.
  "offerDetails": {
    object (OfferDetails)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  },
  "deferredItemRemoval": {
    object (DeferredItemRemoval)
  }
  // End of mutually exclusive fields.
  "signupPromotion": {
    object (SignupPromotion)
  },
  "itemReplacement": {
    object (ItemReplacement)
  },
  "offerPhase": {
    object (OfferPhase)
  }
}
Felder
productId

string

Die Produkt-ID des gekauften Produkts (z. B. „monthly001“).

expiryTime

string (Timestamp format)

Zeitpunkt, zu dem das Abo abgelaufen ist oder ablaufen wird, sofern der Zugriff nicht verlängert wird (z. B. durch Verlängerung).

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".

developerTargetedOffers[]

object (DeveloperTargetedOffer)

Optional. Details zu den für diese Werbebuchung registrierten Angeboten für Entwickler.

latestSuccessfulOrderId

string

Die Bestell-ID der letzten erfolgreichen Bestellung, die mit diesem Artikel verknüpft ist. Nicht vorhanden, wenn der Artikel noch nicht im Besitz des Nutzers ist (z.B. wenn der Artikel ersetzt wird).

Der Typ des Abos. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
autoRenewingPlan

object (AutoRenewingPlan)

Der Artikel wird automatisch verlängert.

prepaidPlan

object (PrepaidPlan)

Der Artikel ist im Voraus bezahlt.

Ende der sich gegenseitig ausschließenden Felder.
offerDetails

object (OfferDetails)

Die Angebotsdetails für diesen Artikel.

Das Feld ist vorhanden, wenn für ein Element eine verzögerte Änderung vorliegt. Sie kann entweder entfernt oder ersetzt werden. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
deferredItemReplacement

object (DeferredItemReplacement)

Informationen zum nachträglichen Ersatz von Artikeln.

deferredItemRemoval

object (DeferredItemRemoval)

Informationen zum verzögerten Entfernen von Elementen.

Ende der sich gegenseitig ausschließenden Felder.
signupPromotion

object (SignupPromotion)

Angebotsdetails zu diesem Artikel. Wird nur festgelegt, wenn bei der Registrierung ein Angebot angewendet wurde.

itemReplacement

object (ItemReplacement)

Details zum ersetzten Artikel. Dieses Feld wird nur ausgefüllt, wenn dieser Artikel einen anderen Artikel in einem früheren Abo ersetzt hat. Es ist nur 60 Tage nach dem Kauf verfügbar.

offerPhase

object (OfferPhase)

Aktuelle Details zur Angebotsphase für diesen Artikel.

AutoRenewingPlan

Informationen zu einem sich automatisch verlängernden Abo.

JSON-Darstellung
{
  "autoRenewEnabled": boolean,
  "recurringPrice": {
    object (Money)
  },
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  },
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  },
  "priceStepUpConsentDetails": {
    object (PriceStepUpConsentDetails)
  }
}
Felder
autoRenewEnabled

boolean

Wenn das Abo derzeit auf automatische Verlängerung eingestellt ist, d.h. der Nutzer hat das Abo nicht gekündigt

recurringPrice

object (Money)

Der aktuelle wiederkehrende Preis des sich automatisch verlängernden Abos. Beachten Sie, dass der Preis keine Rabatte und Steuern enthält. Wenn Sie Preise ohne Steuern benötigen, rufen Sie stattdessen die orders.get API auf, falls Transaktionsdetails erforderlich sind.

priceChangeDetails

object (SubscriptionItemPriceChangeDetails)

Informationen zur letzten Preisänderung für den Artikel seit der Anmeldung für das Abo.

installmentDetails

object (InstallmentPlan)

Die Zusicherung für das Ratenmodell und die statusbezogenen Informationen für das sich automatisch verlängernde Abo.

planTransitionDetails

object (PlanTransitionDetails)

Die Informationen zur zugehörigen Tarifumstellung. Wird nur angezeigt, wenn diesem Plan ein Übergangsplan zugeordnet ist, und enthält nur die neuesten Übergangsdetails, die dem Element zugeordnet sind.

SubscriptionItemPriceChangeDetails

Informationen zu Preisänderungen für einen Aboartikel.

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

object (Money)

Neuer wiederkehrender Preis für den Aboartikel.

priceChangeMode

enum (PriceChangeMode)

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

priceChangeState

enum (PriceChangeState)

Der Status, in dem sich die Preisänderung derzeit befindet.

expectedNewPriceChargeTime

string (Timestamp format)

Der Zeitpunkt der Verlängerung, zu dem die Preisänderung für den Nutzer wirksam wird. Dies kann sich (auf einen späteren Zeitpunkt) ändern, wenn sich der Verlängerungszeitpunkt verschiebt, z. B. durch eine Pause. Dieses Feld wird nur ausgefüllt, wenn die Preisänderung noch nicht wirksam ist.

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".

PriceChangeMode

Der Modus der Preisänderung.

Enums
PRICE_CHANGE_MODE_UNSPECIFIED Modus für Preisänderung nicht angegeben. Dieser Wert sollte nie festgelegt werden.
PRICE_DECREASE Wenn der Abopreis sinkt.
PRICE_INCREASE Wenn der Abopreis steigt und der Nutzer die Erhöhung akzeptieren muss.
OPT_OUT_PRICE_INCREASE Wenn der Abopreis im Opt-out-Modus erhöht wird.

PriceChangeState

Der Status der Preisänderung.

Enums
PRICE_CHANGE_STATE_UNSPECIFIED Status der Preisänderung nicht angegeben. Dieser Wert sollte nicht verwendet werden.
OUTSTANDING Es wird darauf gewartet, dass der Nutzer der Preisänderung zustimmt.
CONFIRMED Die Preisänderung wird für den Nutzer bestätigt.
APPLIED Die Preisänderung wird angewendet, d.h., dem Nutzer wird der neue Preis in Rechnung gestellt.
CANCELED Die Preisänderung wurde storniert.

InstallmentPlan

Informationen zu einem Ratenzahlungsplan.

JSON-Darstellung
{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}
Felder
initialCommittedPaymentsCount

integer

Gesamtzahl der Zahlungen, zu denen sich der Nutzer anfänglich verpflichtet hat.

subsequentCommittedPaymentsCount

integer

Gesamtzahl der Zahlungen, zu denen sich der Nutzer nach jeder Mindestlaufzeit verpflichtet. Wenn das Feld leer ist, wird das Ratenzahlungsmodell nach der ersten Laufzeit auf ein normales Abo mit automatischer Verlängerung umgestellt.

remainingCommittedPaymentsCount

integer

Gesamtzahl der zugesicherten Zahlungen, die in diesem Verlängerungszyklus noch zu leisten sind.

pendingCancellation

object (PendingCancellation)

Falls vorhanden, wird die Kündigung dieses Ratenzahlungsmodells gerade bearbeitet. Die Kündigung erfolgt erst, nachdem der Nutzer alle zugesagten Zahlungen geleistet hat.

PendingCancellation

Dieser Typ hat keine Felder.

Dies ist ein Indikator dafür, ob eine Kündigung des virtuellen Ratenzahlungsplans aussteht. Die Kündigung erfolgt erst, nachdem der Nutzer alle zugesagten Zahlungen geleistet hat.

PlanTransitionDetails

Informationen zu einer Tarifumstellung.

JSON-Darstellung
{
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "transitionInfo": {
    object (TransitionInfo)
  }
}
Felder
productId

string

[Erforderlich] Die Produkt-ID, zu der dieses Abo umgestellt wird, z. B. „monthly001“.

basePlanId

string

[Erforderlich] Die Basis-Abo-ID, zu der dieses Abo umgestellt wird.

offerId

string

Die Angebots-ID. Nur für rabattierte Angebote vorhanden. Dies wird nur festgelegt, wenn das Ziel-Abo kein Basis-Abo ist.

transitionInfo

object (TransitionInfo)

Zusätzliche Informationen zur geplanten Tarifumstellung. Wird nur angezeigt, wenn eine Tarifumstellung geplant wurde.

TransitionInfo

Informationen zu einer geplanten Tarifumstellung.

JSON-Darstellung
{
  "transitionState": enum (TransitionState),
  "price": {
    object (Money)
  },
  "expectedTransitionTime": string
}
Felder
transitionState

enum (TransitionState)

Nur Ausgabe. [Erforderlich] Der aktuelle Status der Umstellung.

price

object (Money)

Der Standardpreis des Basis-Abos, auf das das Abo umgestellt wird.

expectedTransitionTime

string (Timestamp format)

Der aktuelle voraussichtliche Zeitpunkt, zu dem der Plan umgestellt werden kann. Dies kann sich (auf einen zukünftigen Zeitpunkt) ändern, wenn sich der Verlängerungszeitpunkt verschiebt, z. B. durch Pausieren und Kontosperre.

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".

TransitionState

Die potenziellen Status, in denen sich eine Umstellung befinden kann.

Enums
TRANSITION_STATE_UNSPECIFIED Nicht angegebener Übergangsstatus.
SCHEDULED Die Umstellung ist für einen späteren Zeitpunkt geplant.
IN_PROGRESS Der Umstellungsprozess wurde eingeleitet und die erste Benachrichtigung zur Umstellung wurde an den Nutzer gesendet.
COMPLETED Die Umstellung ist abgeschlossen.
CANCELED Die Umstellung wurde abgebrochen.

PriceStepUpConsentDetails

Informationen zu einer Preiserhöhung, die die Nutzereinwilligung erfordert.

JSON-Darstellung
{
  "state": enum (ConsentState),
  "consentDeadlineTime": string,
  "newPrice": {
    object (Money)
  }
}
Felder
state

enum (ConsentState)

Nur Ausgabe. Der Status der Einwilligung zur Preiserhöhung.

consentDeadlineTime

string (Timestamp format)

Die Frist, innerhalb derer der Nutzer seine Einwilligung erteilen muss. Wenn die Einwilligung bis dahin nicht erteilt wird, wird das Abo gekündigt.

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".

newPrice

object (Money)

Der neue Preis, für den die Nutzereinwilligung erforderlich ist.

ConsentState

Der Status der Einwilligung zur Preiserhöhung.

Enums
CONSENT_STATE_UNSPECIFIED Nicht angegebener Einwilligungsstatus.
PENDING Der Nutzer hat noch keine Einwilligung erteilt.
CONFIRMED Der Nutzer hat zugestimmt und der neue Preis wird bald wirksam.
COMPLETED Der Nutzer hat zugestimmt und der neue Preis ist in Kraft getreten.

PrepaidPlan

Informationen zu einem Prepaid-Tarif.

JSON-Darstellung
{
  "allowExtendAfterTime": string
}
Felder
allowExtendAfterTime

string (Timestamp format)

Falls vorhanden, ist dies der Zeitpunkt, ab dem Aufladungen für den Prepaid-Tarif zulässig sind. Wird bei abgelaufenen Prepaid-Tarifen nicht angezeigt.

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".

OfferDetails

Angebotsdetails zu einer Kaufposition.

JSON-Darstellung
{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}
Felder
offerTags[]

string

Die neuesten Angebotstags, die mit dem Angebot verknüpft sind. Er enthält Tags, die vom Basis-Abo übernommen wurden.

basePlanId

string

Die Basis-Abo-ID. Für alle Basis-Abos und Angebote vorhanden.

offerId

string

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

DeferredItemReplacement

Informationen zum verzögerten Ersetzen von Artikeln.

JSON-Darstellung
{
  "productId": string
}
Felder
productId

string

Die productId, die die vorhandene productId ersetzt.

DeferredItemRemoval

Dieser Typ hat keine Felder.

Informationen zum verzögerten Ersetzen von Artikeln.

SignupPromotion

Das Angebot, das beim Kauf auf diesen Artikel angewendet wurde.

JSON-Darstellung
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "oneTimeCode": {
    object (OneTimeCode)
  },
  "vanityCode": {
    object (VanityCode)
  }
  // End of mutually exclusive fields.
}
Felder
Die Art des Angebots, das auf den Artikel angewendet wird. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
oneTimeCode

object (OneTimeCode)

Ein Einmalcode wurde angewendet.

vanityCode

object (VanityCode)

Ein Vanity-Code wurde angewendet.

Ende der sich gegenseitig ausschließenden Felder.

OneTimeCode

Dieser Typ hat keine Felder.

Ein Gutscheincode für einmaligen Gebrauch.

VanityCode

Ein vordefinierter Gutscheincode, der mehrfach verwendet werden kann.

JSON-Darstellung
{
  "promotionCode": string
}
Felder
promotionCode

string

Der Gutscheincode.

ItemReplacement

Details zu einer Abo-Werbebuchung, die ersetzt wird.

JSON-Darstellung
{
  "productId": string,
  "replacementMode": enum (ReplacementMode),
  "basePlanId": string,
  "offerId": string
}
Felder
productId

string

Die Produkt-ID der Abo-Werbebuchung, die ersetzt wird.

replacementMode

enum (ReplacementMode)

Der beim Kauf angewendete Ersetzungsmodus.

basePlanId

string

Die Basis-Abo-ID der Abo-Werbebuchung, die ersetzt wird.

offerId

string

Die Angebots-ID des Abo-Werbebuchungselements, das ersetzt wird, falls zutreffend.

ReplacementMode

Der Ersetzungsmodus für ein Abo.

Enums
REPLACEMENT_MODE_UNSPECIFIED Nicht angegebener Ersetzungsmodus.
WITH_TIME_PRORATION Das neue Abo wird anteilig berechnet und das alte Abo wird angerechnet.
CHARGE_PRORATED_PRICE Dem Nutzer wird ein anteiliger Preis für das neue Abo in Rechnung gestellt.
WITHOUT_PRORATION Das neue Abo ersetzt das alte, ohne dass die Zeit anteilig angerechnet wird.
CHARGE_FULL_PRICE Dem Nutzer wird der volle Preis für das neue Abo in Rechnung gestellt.
DEFERRED Das alte Abo wird gekündigt und das neue Abo tritt nach Ablauf des alten Abos in Kraft.
KEEP_EXISTING Der Plan bleibt bei diesem Ersatz unverändert.

OfferPhase

Details zur Angebotsphase.

JSON-Darstellung
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "prorationPeriod": {
    object (ProrationPeriodOfferPhase)
  },
  "freeTrial": {
    object (FreeTrialOfferPhase)
  },
  "introductoryPrice": {
    object (IntroductoryPriceOfferPhase)
  },
  "basePrice": {
    object (BasePriceOfferPhase)
  }
  // End of mutually exclusive fields.
}
Felder
Die Details der Angebotsphase. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
prorationPeriod

object (ProrationPeriodOfferPhase)

Wird festgelegt, wenn die Angebotsphase ein anteiliger Zeitraum ist.

freeTrial

object (FreeTrialOfferPhase)

Wird festgelegt, wenn die Angebotsphase ein kostenloser Testzeitraum ist.

introductoryPrice

object (IntroductoryPriceOfferPhase)

Wird festgelegt, wenn die Angebotsphase eine Angebotsphase mit Einführungspreis ist.

basePrice

object (BasePriceOfferPhase)

Wird festgelegt, wenn die Angebotsphase eine Preisphase für das Basis-Abo ist.

Ende der sich gegenseitig ausschließenden Felder.

ProrationPeriodOfferPhase

Details zur Angebotsphase des anteiligen Zeitraums.

JSON-Darstellung
{
  "originalOfferPhaseType": enum (OriginalOfferPhaseType)
}
Felder
originalOfferPhaseType

enum (OriginalOfferPhaseType)

Der ursprüngliche Angebotsphasentyp vor dem anteiligen Zeitraum. Wird nur festgelegt, wenn der anteilige Zeitraum von einer vorhandenen Angebotsphase aktualisiert wird.

OriginalOfferPhaseType

Die ursprüngliche Angebotsphase der Angebotszahlung, wenn die Angebotszahlung eine anteilige Zahlung ist.

Enums
ORIGINAL_OFFER_PHASE_TYPE_UNSPECIFIED Nicht angegebener Typ der ursprünglichen Angebotsphase.
BASE Das Abo befindet sich in der Basispreisphase (z.B. voller Preis).
INTRODUCTORY Das Abo befindet sich in einer Phase mit Einführungspreis.
FREE_TRIAL Das Abo befindet sich in einem kostenlosen Testzeitraum.

FreeTrialOfferPhase

Dieser Typ hat keine Felder.

Details zur Phase des kostenlosen Testzeitraums.

IntroductoryPriceOfferPhase

Dieser Typ hat keine Felder.

Details zur Phase des Einführungspreisangebots.

BasePriceOfferPhase

Dieser Typ hat keine Felder.

Details zur Angebotsphase für den Basispreis.

DeveloperTargetedOffer

Informationen zu einem auf Entwickler ausgerichteten Angebot für eine Abo-Werbebuchung.

JSON-Darstellung
{
  "offerId": string,
  "activateTime": string
}
Felder
offerId

string

Optional. Die vom Entwickler erstellte Angebots-ID für das Abo.

activateTime

string (Timestamp format)

Optional. Zeitpunkt, zu dem das Targeting für das Angebot aktiviert wurde.

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".

OutOfAppPurchaseContext

Informationen zu einem Out-of-App-Kauf.

JSON-Darstellung
{
  "expiredExternalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "expiredPurchaseToken": string
}
Felder
expiredExternalAccountIdentifiers

object (ExternalAccountIdentifiers)

Nutzerkonto-ID des letzten abgelaufenen Abos für diese SKU.

expiredPurchaseToken

string

Das Kaufftoken des letzten abgelaufenen Abos. Dieses Kauf-Token darf nur zur Identifizierung des Nutzers verwendet werden, wenn die Verknüpfung zwischen dem „purchaseToken“ und dem Nutzer in Ihrer Datenbank gespeichert ist. Wenn das Token vor mehr als 60 Tagen abgelaufen ist, kann es nicht mehr zum Aufrufen der Google Developer API verwendet werden.

OnHoldStateContext

Zusätzlicher Kontext zu Abos im Status ON_HOLD.

JSON-Darstellung
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "renewalDeclined": {
    object (RenewalDeclinedContext)
  }
  // End of mutually exclusive fields.
}
Felder
Der Grund, warum das Abo den Status ON_HOLD hat. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
renewalDeclined

object (RenewalDeclinedContext)

Optional. Die Zahlung für die Verlängerung wurde abgelehnt.

Ende der sich gegenseitig ausschließenden Felder.

RenewalDeclinedContext

Kontext zum Szenario „Verlängerung abgelehnt“.

JSON-Darstellung
{
  "pendingOrderId": string
}
Felder
pendingOrderId

string

Erforderlich. Die ID der ausstehenden oder fehlgeschlagenen Bestellung, die den Status verursacht.

InGracePeriodStateContext

Zusätzlicher Kontext zu Abos im Status IN_GRACE_PERIOD.

JSON-Darstellung
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "renewalDeclined": {
    object (RenewalDeclinedContext)
  }
  // End of mutually exclusive fields.
}
Felder
Der Grund, warum sich das Abo im Status IN_GRACE_PERIOD befindet. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
renewalDeclined

object (RenewalDeclinedContext)

Optional. Die Zahlung für die Verlängerung wurde abgelehnt.

Ende der sich gegenseitig ausschließenden Felder.

Methoden

activateoffertargeting

Aktiviert das Targeting für ein bestimmtes Angebot.

cancel

Abo-Kauf für den Nutzer kündigen.

cancelplantransition

Tarifwechsel für ein Abo abbrechen

deactivateoffertargeting

Deaktiviert das Targeting für ein bestimmtes Angebot.

defer

Verschiebt die Verlängerung eines Abos.

get

Metadaten zu einem Abo abrufen

revoke

Abokauf für den Nutzer widerrufen

scheduleplantransition

Abo-Wechsel für ein Abo planen.

Fehlercodes

Die Vorgänge dieser Ressource geben die folgenden HTTP-Fehlercodes zurück:

Fehlercode Grund Beschreibung Auflösung
400 / 410 subscriptionExpired Das Abo ist abgelaufen und der angeforderte Vorgang kann nicht ausgeführt werden. Prüfen Sie die Ablaufzeit des Abos. Dieser Vorgang ist für abgelaufene Abos nicht zulässig.
400 subscriptionInvalidArgument In der Anfrage für das Abo wurde ein ungültiges Argument angegeben. Sehen Sie sich die API-Dokumentation an und achten Sie darauf, dass alle erforderlichen Felder angegeben und korrekt formatiert sind.
400 invalidPurchaseState Der Kauf hat keinen gültigen Status, um den angeforderten Vorgang auszuführen. Beispielsweise versuchen Sie möglicherweise, einen bereits verbrauchten Kauf zu bestätigen oder ein nicht aktives Abo zu kündigen. Prüfen Sie den aktuellen Status der Ressource mit der entsprechenden Get API, bevor Sie den Vorgang ausführen. Achten Sie darauf, dass sich die Ressource in einem für die Aktion geeigneten Zustand befindet.
400 invalidValue In der Anfrage wurde ein ungültiger Wert angegeben. Dies wird häufig bei einem fehlerhaften oder ungültigen Kaufftoken zurückgegeben. Korrigieren Sie den ungültigen Feldwert im Anfragetext oder in den Parametern gemäß der API-Referenz.
400 prepaidSubscriptionNotSupported Der angeforderte Vorgang wird für Prepaid-Abos nicht unterstützt. Prüfen Sie, ob der Vorgang für den Abotyp zulässig ist. Dieser Fehler tritt nur bei Methoden wie „Cancel“ auf.
400 productNotOwnedByUser Das angegebene Kaufftoken ist gültig, aber der Nutzer besitzt das Produkt derzeit nicht. Das kann passieren, wenn der Kauf vor der Bestätigung erstattet, widerrufen oder abgelaufen ist. Prüfen Sie den aktuellen Status der Ressource mit der entsprechenden Get API, bevor Sie den Vorgang ausführen. Achten Sie darauf, dass sich die Ressource in einem für die Aktion geeigneten Zustand befindet.
400 purchaseTokenMismatch Das angegebene Kaufftoken stimmt nicht mit dem Kauf, dem Paketnamen, der Abo-ID oder der Produkt-ID überein. Prüfen Sie, ob alle Angaben im Antrag korrekt sind und übereinstimmen.
400 required In der Anfrage fehlt ein erforderliches Feld oder ein erforderlicher Parameter. In der API-Dokumentation finden Sie Informationen dazu, welche Pflichtfelder und Parameter enthalten sein müssen.
400 unsupportedIabType Der Vorgang wird für den angegebenen In-App-Abrechnungstyp nicht unterstützt. Die API-Methode muss mit dem verwalteten Artikeltyp kompatibel sein.
403 userInsufficientPermission Der Nutzer hat nicht die erforderliche Berechtigung, um den angeforderten Vorgang auszuführen. Prüfen Sie, ob der authentifizierte Nutzer die erforderlichen Berechtigungen in der Google Play Console hat. Weitere Informationen finden Sie unter Dienstkonto verwenden.
404 notFound Die angeforderte Ressource wurde nicht gefunden. Prüfen Sie, ob die Kennzeichnungen (z.B. Kaufftoken, Paketname, Produkt-ID, Abo-ID) korrekt sind.
409 concurrentUpdate Es wurde versucht, ein Objekt zu aktualisieren, das gleichzeitig aktualisiert wird. Wiederholen Sie die Anfrage mit exponentiellem Backoff. Vermeiden Sie gleichzeitige Änderungen an derselben Ressource.
410 purchaseTokenNoLongerValid Das Kaufftoken ist dauerhaft ungültig, weil das zugehörige Nutzerkonto gelöscht wurde oder der Kaufdatensatz nicht mehr vorhanden ist. Verwenden Sie dieses Kaufftoken nicht mehr.
410 subscriptionNoLongerAvailable Der Abokauf kann nicht mehr abgefragt werden, da er zu lange abgelaufen ist. Dieser Fehler weist darauf hin, dass das Abo seit mehr als 60 Tagen abgelaufen ist. Sie sollten diese Abos nicht mehr abfragen.
5xx Generic error Allgemeiner Fehler auf dem Google Play-Server. Wiederholen Sie Ihre Anfrage.

Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Google Play Account Manager oder reichen Sie eine Supportanfrage ein. Prüfen Sie im Play-Status-Dashboard, ob bekannte Ausfälle vorliegen.