- Ressource: SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- InstallmentPlan
- PendingCancellation
- PlanTransitionDetails
- TransitionInfo
- TransitionState
- PriceStepUpConsentDetails
- ConsentState
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- DeferredItemRemoval
- SignupPromotion
- OneTimeCode
- VanityCode
- ItemReplacement
- ReplacementMode
- OfferPhase
- ProrationPeriodOfferPhase
- OriginalOfferPhaseType
- FreeTrialOfferPhase
- IntroductoryPriceOfferPhase
- BasePriceOfferPhase
- DeveloperTargetedOffer
- OutOfAppPurchaseContext
- OnHoldStateContext
- RenewalDeclinedContext
- InGracePeriodStateContext
- Methoden
Ressource: SubscriptionPurchaseV2
Gibt den Status des Abokaufs eines Nutzers an.
| JSON-Darstellung |
|---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
| Felder | |
|---|---|
kind |
Diese Art stellt ein SubscriptionPurchaseV2-Objekt im androidpublisher-Dienst dar. |
regionCode |
ISO 3166-1 Alpha-2-Ländercode des Landes der Rechnungsadresse des Nutzers zum Zeitpunkt der Gewährung des Abos. |
lineItems[] |
Informationen auf Artikelebene für einen Abokauf. Die Artikel im selben Kauf sollten entweder alle mit AutoRenewingPlan oder alle mit PrepaidPlan sein. |
startTime |
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: |
subscriptionState |
Der aktuelle Status des Abos. |
linkedPurchaseToken |
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 |
Zusätzlicher Kontext zu pausierten Abos. Wird nur angezeigt, wenn das Abo derzeit den Status „subscriptionState“ „SUBSCRIPTION_STATE_PAUSED“ hat. |
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 |
Nur vorhanden, wenn es sich bei diesem Abokauf um einen Testkauf handelt. |
acknowledgementState |
Der Bestätigungsstatus des Abos. |
externalAccountIdentifiers |
Nutzerkonto-ID im Drittanbieterdienst. |
subscribeWithGoogleInfo |
Nutzerprofil, das mit Käufen über „Abonnieren mit Google“ verknüpft ist. |
etag |
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 |
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 |
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 |
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 |
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: |
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 ( |
| 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 |
Das Abo wurde vom Nutzer gekündigt. |
systemInitiatedCancellation |
Das Abo wurde vom System gekündigt, z. B. aufgrund eines Abrechnungsproblems. |
developerInitiatedCancellation |
Das Abo wurde vom Entwickler gekündigt. |
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 ( |
| Felder | |
|---|---|
cancelSurveyResult |
Informationen, die der Nutzer beim Kündigen des Abos angibt (Umfrage zum Kündigungsgrund). |
cancelTime |
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: |
CancelSurveyResult
Ergebnis der Umfrage zur Kündigung, wenn das Abo vom Nutzer gekündigt wurde.
| JSON-Darstellung |
|---|
{
"reason": enum ( |
| Felder | |
|---|---|
reason |
Der Grund, den der Nutzer in der Umfrage zur Kündigung ausgewählt hat. |
reasonUserInput |
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_COST_RELATED |
Kostenbezogene Probleme. |
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 |
Nutzerkonto-ID im Drittanbieterdienst. Nur vorhanden, wenn die Kontoverknüpfung im Rahmen des Abo-Kaufvorgangs erfolgt ist. |
obfuscatedExternalAccountId |
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 |
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 |
Die Google-Profil-ID des Nutzers, als das Abo gekauft wurde. |
profileName |
Der Profilname des Nutzers, als das Abo gekauft wurde. |
emailAddress |
Die E-Mail-Adresse des Nutzers, die beim Kauf des Abos verwendet wurde. |
givenName |
Der Vorname des Nutzers beim Kauf des Abos. |
familyName |
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 ( |
| Felder | |
|---|---|
productId |
Die Produkt-ID des gekauften Produkts (z. B. „monthly001“). |
expiryTime |
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: |
developerTargetedOffers[] |
Optional. Details zu den für diese Werbebuchung registrierten Angeboten für Entwickler. |
latestSuccessfulOrderId |
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 |
Der Artikel wird automatisch verlängert. |
prepaidPlan |
Der Artikel ist im Voraus bezahlt. |
| Ende der sich gegenseitig ausschließenden Felder. | |
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 |
Informationen zum nachträglichen Ersatz von Artikeln. |
deferredItemRemoval |
Informationen zum verzögerten Entfernen von Elementen. |
| Ende der sich gegenseitig ausschließenden Felder. | |
signupPromotion |
Angebotsdetails zu diesem Artikel. Wird nur festgelegt, wenn bei der Registrierung ein Angebot angewendet wurde. |
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 |
Aktuelle Details zur Angebotsphase für diesen Artikel. |
AutoRenewingPlan
Informationen zu einem sich automatisch verlängernden Abo.
| JSON-Darstellung |
|---|
{ "autoRenewEnabled": boolean, "recurringPrice": { object ( |
| Felder | |
|---|---|
autoRenewEnabled |
Wenn das Abo derzeit auf automatische Verlängerung eingestellt ist, d.h. der Nutzer hat das Abo nicht gekündigt |
recurringPrice |
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 |
priceChangeDetails |
Informationen zur letzten Preisänderung für den Artikel seit der Anmeldung für das Abo. |
installmentDetails |
Die Zusicherung für das Ratenmodell und die statusbezogenen Informationen für das sich automatisch verlängernde Abo. |
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. |
priceStepUpConsentDetails |
Die Informationen zur letzten Einwilligung bei Preiserhöhungen. |
SubscriptionItemPriceChangeDetails
Informationen zu Preisänderungen für einen Aboartikel.
| JSON-Darstellung |
|---|
{ "newPrice": { object ( |
| Felder | |
|---|---|
newPrice |
Neuer wiederkehrender Preis für den Aboartikel. |
priceChangeMode |
Der Preisänderungsmodus gibt an, wie sich der Preis des Aboartikels ändert. |
priceChangeState |
Der Status, in dem sich die Preisänderung derzeit befindet. |
expectedNewPriceChargeTime |
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: |
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 ( |
| Felder | |
|---|---|
initialCommittedPaymentsCount |
Gesamtzahl der Zahlungen, zu denen sich der Nutzer anfänglich verpflichtet hat. |
subsequentCommittedPaymentsCount |
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 |
Gesamtzahl der zugesicherten Zahlungen, die in diesem Verlängerungszyklus noch zu leisten sind. |
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 ( |
| Felder | |
|---|---|
productId |
[Erforderlich] Die Produkt-ID, zu der dieses Abo umgestellt wird, z. B. „monthly001“. |
basePlanId |
[Erforderlich] Die Basis-Abo-ID, zu der dieses Abo umgestellt wird. |
offerId |
Die Angebots-ID. Nur für rabattierte Angebote vorhanden. Dies wird nur festgelegt, wenn das Ziel-Abo kein Basis-Abo ist. |
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 ( |
| Felder | |
|---|---|
transitionState |
Nur Ausgabe. [Erforderlich] Der aktuelle Status der Umstellung. |
price |
Der Standardpreis des Basis-Abos, auf das das Abo umgestellt wird. |
expectedTransitionTime |
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: |
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 ( |
| Felder | |
|---|---|
state |
Nur Ausgabe. Der Status der Einwilligung zur Preiserhöhung. |
consentDeadlineTime |
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: |
newPrice |
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 |
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: |
OfferDetails
Angebotsdetails zu einer Kaufposition.
| JSON-Darstellung |
|---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
| Felder | |
|---|---|
offerTags[] |
Die neuesten Angebotstags, die mit dem Angebot verknüpft sind. Er enthält Tags, die vom Basis-Abo übernommen wurden. |
basePlanId |
Die Basis-Abo-ID. Für alle Basis-Abos und Angebote vorhanden. |
offerId |
Die Angebots-ID. Nur für rabattierte Angebote vorhanden. |
DeferredItemReplacement
Informationen zum verzögerten Ersetzen von Artikeln.
| JSON-Darstellung |
|---|
{ "productId": string } |
| Felder | |
|---|---|
productId |
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 ( |
| 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 |
Ein Einmalcode wurde angewendet. |
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 |
Der Gutscheincode. |
ItemReplacement
Details zu einer Abo-Werbebuchung, die ersetzt wird.
| JSON-Darstellung |
|---|
{
"productId": string,
"replacementMode": enum ( |
| Felder | |
|---|---|
productId |
Die Produkt-ID der Abo-Werbebuchung, die ersetzt wird. |
replacementMode |
Der beim Kauf angewendete Ersetzungsmodus. |
basePlanId |
Die Basis-Abo-ID der Abo-Werbebuchung, die ersetzt wird. |
offerId |
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 ( |
| 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 |
Wird festgelegt, wenn die Angebotsphase ein anteiliger Zeitraum ist. |
freeTrial |
Wird festgelegt, wenn die Angebotsphase ein kostenloser Testzeitraum ist. |
introductoryPrice |
Wird festgelegt, wenn die Angebotsphase eine Angebotsphase mit Einführungspreis ist. |
basePrice |
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 ( |
| Felder | |
|---|---|
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 |
Optional. Die vom Entwickler erstellte Angebots-ID für das Abo. |
activateTime |
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: |
OutOfAppPurchaseContext
Informationen zu einem Out-of-App-Kauf.
| JSON-Darstellung |
|---|
{
"expiredExternalAccountIdentifiers": {
object ( |
| Felder | |
|---|---|
expiredExternalAccountIdentifiers |
Nutzerkonto-ID des letzten abgelaufenen Abos für diese SKU. |
expiredPurchaseToken |
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 ( |
| 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 |
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 |
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 ( |
| 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 |
Optional. Die Zahlung für die Verlängerung wurde abgelehnt. |
| Ende der sich gegenseitig ausschließenden Felder. | |
Methoden |
|
|---|---|
|
Aktiviert das Targeting für ein bestimmtes Angebot. |
|
Abo-Kauf für den Nutzer kündigen. |
|
Tarifwechsel für ein Abo abbrechen |
|
Deaktiviert das Targeting für ein bestimmtes Angebot. |
|
Verschiebt die Verlängerung eines Abos. |
|
Metadaten zu einem Abo abrufen |
|
Abokauf für den Nutzer widerrufen |
|
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. |