- Ressource: SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem.
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- Methoden
Ressource: SubscriptionPurchaseV2
Zeigt den Status des Abokaufs eines Nutzers an.
JSON-Darstellung |
---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
Felder | |
---|---|
kind |
Diese Art repräsentiert ein SubscriptionPurchaseV2-Objekt im Androidpublisher-Dienst. |
regionCode |
ISO 3166-1 Alpha-2-Rechnungsland-/Regionscode des Nutzers zum Zeitpunkt der Abobewilligung. |
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 für ausstehende Abonnements festgelegt (Abo wurde erstellt, aber bei der Registrierung steht die Zahlung aus). Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
subscriptionState |
Der aktuelle Status des Abos. |
latestOrderId |
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 der Registrierungsbestellung, falls diese noch nicht verlängert wurde, oder die letzte Dauerauftrags-ID (erfolgreiche, ausstehende oder abgelehnte Bestellung). Bei einem Prepaid-Abo ist dies die Bestell-ID, die dem abgefragten Kauftoken zugeordnet ist. |
linkedPurchaseToken |
Das Kauftoken des alten Abos, wenn es sich bei diesem Abo um eines der folgenden Abos handelt: * Erneute Registrierung eines gekündigten, aber nicht abgelaufenen Abos * Upgrade/Downgrade eines früheren Abos. * Wechseln Sie von einem Prepaid-Tarif in ein Abo mit automatischer Verlängerung. * Wechseln Sie von einem Abo mit automatischer Verlängerung zu einem Prepaid-Tarif. * Prepaid-Abo aufladen. |
pausedStateContext |
Zusätzlicher Kontext zu pausierten Abos. Ist nur vorhanden, wenn für das Abo derzeit subscriptionState SUBSCRIPTION_STATE_PAUSED angegeben ist. |
canceledStateContext |
Weitere Informationen zu gekündigten Abos. Ist nur vorhanden, wenn für das Abo derzeit subscriptionState SUBSCRIPTION_STATE_CANCELED ist. |
testPurchase |
Nur vorhanden, wenn es sich bei diesem Abokauf um einen Testkauf handelt. |
acknowledgementState |
Der Bestätigungsstatus des Abos. |
externalAccountIdentifiers |
ID des Nutzerkontos im Drittanbieterdienst. |
subscribeWithGoogleInfo |
Nutzerprofil, das mit Käufen über „Abonnieren mit Google“ verknüpft ist. |
SubscriptionState
Die möglichen Status, in denen ein Abo sein kann, z. B. ob es aktiv oder gekündigt ist. Die Bestandteile eines Abonnementkaufs können entweder alle Tarife mit automatischer Verlängerung oder Prepaid-Tarife sein.
Enums | |
---|---|
SUBSCRIPTION_STATE_UNSPECIFIED |
Nicht angegebener Abostatus. |
SUBSCRIPTION_STATE_PENDING |
Das Abo wurde erstellt, aber bei der Registrierung steht eine Zahlung aus. In diesem Status stehen für alle Artikel Zahlungen aus. |
SUBSCRIPTION_STATE_ACTIVE |
Abonnement ist aktiv. – (1) Wenn es sich bei dem Abo um einen Plan mit automatischer Verlängerung handelt, muss mindestens ein Artikel den Status „autoRenewEnabled“ haben und nicht abgelaufen sein. - (2) Wenn es sich bei dem Abonnement um einen Prepaid-Tarif handelt, ist mindestens ein Artikel nicht abgelaufen. |
SUBSCRIPTION_STATE_PAUSED |
Das Abo wurde pausiert. Der Status ist nur verfügbar, wenn das Abo ein Tarif mit automatischer Verlängerung ist. In diesem Status befinden sich alle Elemente im Status „Pausiert“. |
SUBSCRIPTION_STATE_IN_GRACE_PERIOD |
Abo befindet sich im Kulanzzeitraum. Der Status ist nur verfügbar, wenn das Abo ein Tarif mit automatischer Verlängerung ist. In diesem Status befinden sich alle Elemente im Kulanzzeitraum. |
SUBSCRIPTION_STATE_ON_HOLD |
Abo wurde ausgesetzt (gesperrt). Der Status ist nur verfügbar, wenn das Abo ein Tarif mit automatischer Verlängerung ist. In diesem Status sind alle Elemente auf „Hold“ gesetzt. |
SUBSCRIPTION_STATE_CANCELED |
Das Abo wurde gekündigt, ist aber noch nicht abgelaufen. Der Status ist nur verfügbar, wenn das Abo ein Tarif mit automatischer Verlängerung ist. Für alle Elemente ist autoRenewEnabled auf "false" gesetzt. |
SUBSCRIPTION_STATE_EXPIRED |
Abo ist abgelaufen. Alle Elemente haben eine expiryTime in der Vergangenheit. |
PausedStateContext
Spezifische Informationen zu einem Abo im pausierten Status.
JSON-Darstellung |
---|
{ "autoResumeTime": string } |
Felder | |
---|---|
autoResumeTime |
Zeitpunkt, zu dem das Abo automatisch fortgesetzt wird. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
CanceledStateContext
Informationen zu einem gekündigten Abo.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld cancellation_reason . Der Grund, warum ein Abo gekündigt wurde. Für cancellation_reason ist nur einer der folgenden Werte zulässig: |
|
userInitiatedCancellation |
Das Abo wurde vom Nutzer gekündigt. |
systemInitiatedCancellation |
Das Abo wurde vom System gekündigt, beispielsweise aufgrund eines Abrechnungsproblems. |
developerInitiatedCancellation |
Das Abo wurde vom Entwickler gekündigt. |
replacementCancellation |
Das Abo wurde durch ein neues Abo ersetzt. |
UserInitiatedCancellation
Spezifische Informationen zu von Nutzern veranlassten Kündigungen.
JSON-Darstellung |
---|
{
"cancelSurveyResult": {
object ( |
Felder | |
---|---|
cancelSurveyResult |
Informationen, die der Nutzer beim Abschließen des Abo-Kündigungsvorgangs angegeben hat (Umfrage zu Kündigungsgründen). |
cancelTime |
Der Zeitpunkt, zu dem das Abo vom Nutzer gekündigt wurde. Möglicherweise hat der Nutzer auch nach dieser Zeit noch 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 Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
CancelSurveyResult
Ergebnis der Kündigungsumfrage, als 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 |
Nur für CANCEL_SURVEY_REASON_OTHERS festgelegt. Dies ist die freie Antwort des Nutzers in der 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 die Kündigung der Umfrage. |
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE |
Das Abo wurde zu wenig 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 |
Andere Gründe. |
SystemInitiatedCancellation
Dieser Typ hat keine Felder.
Informationen zu Stornierungen, die durch das Google-System eingeleitet wurden
DeveloperInitiatedCancellation
Dieser Typ hat keine Felder.
Informationen zu von Entwicklern veranlassten Kündigungen
ReplacementCancellation
Dieser Typ hat keine Felder.
Informationen zu Kündigungen, die durch den Austausch eines Abos verursacht wurden.
TestPurchase
Dieser Typ hat keine Felder.
Gibt an, ob es sich bei diesem Abokauf um einen Testkauf handelt.
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 wurde bestätigt. |
ExternalAccountIdentifiers
ID des Nutzerkontos im Drittanbieterdienst.
JSON-Darstellung |
---|
{ "externalAccountId": string, "obfuscatedExternalAccountId": string, "obfuscatedExternalProfileId": string } |
Felder | |
---|---|
externalAccountId |
ID des Nutzerkontos im Drittanbieterdienst. Nur vorhanden, wenn die Kontoverknüpfung im Rahmen des Abokaufs erfolgte. |
obfuscatedExternalAccountId |
Eine verschleierte Version der ID, die dem Konto des Nutzers in Ihrer App eindeutig zugeordnet ist. Für die folgenden Käufe vorhanden: * Wenn die Kontoverknüpfung im Rahmen des Abokaufs erfolgt ist. * Er 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 dem Nutzerprofil in Ihrer App zugeordnet ist. Nur vorhanden, wenn beim Kauf mit https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid angegeben wurde. |
SubscribeWithGoogleInfo
Informationen im Zusammenhang mit Käufen über „Abonnieren mit Google“.
JSON-Darstellung |
---|
{ "profileId": string, "profileName": string, "emailAddress": string, "givenName": string, "familyName": string } |
Felder | |
---|---|
profileId |
Die Google-Profil-ID des Nutzers beim Kauf des Abos. |
profileName |
Der Profilname des Nutzers beim Kauf des Abos. |
emailAddress |
Die E-Mail-Adresse des Nutzers beim Kauf des Abos. |
givenName |
Der Vorname des Nutzers beim Kauf des Abos. |
familyName |
Der Familienname des Nutzers beim Kauf des Abos. |
SubscriptionPurchaseLineItem
Informationen auf Artikelebene für einen Abokauf.
JSON-Darstellung |
---|
{ "productId": string, "expiryTime": string, // Union field |
Felder | |
---|---|
productId |
Die ID des gekauften Produkts, z. B. „monthly001“ |
expiryTime |
Zeitpunkt, zu dem das Abonnement abgelaufen ist oder abläuft, sofern der Zugriff nicht verlängert wird (z. B. Verlängerung). Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
Union-Feld plan_type . Der Abotyp. Für plan_type ist nur einer der folgenden Werte zulässig: |
|
autoRenewingPlan |
Der Artikel wird automatisch verlängert. |
prepaidPlan |
Der Artikel ist im Voraus bezahlt. |
offerDetails |
Die Angebotsdetails für diesen Artikel. |
Union-Feld deferred_item_change . Das Feld ist vorhanden, wenn ein Element eine nachträgliche Änderung aufweist. Sie kann entweder entfernt oder ersetzt werden. Für deferred_item_change ist nur einer der folgenden Werte zulässig: |
|
deferredItemReplacement |
Informationen zum verzögerten Ersatz von Artikeln. |
AutoRenewingPlan
Informationen zu einem Tarif mit automatischer Verlängerung.
JSON-Darstellung |
---|
{
"autoRenewEnabled": boolean,
"priceChangeDetails": {
object ( |
Felder | |
---|---|
autoRenewEnabled |
Wenn das Abo derzeit auf „Automatisch verlängern“ eingestellt ist, z.B. wenn der Nutzer das Abo nicht gekündigt hat |
priceChangeDetails |
Die Informationen zur letzten Preisänderung für den Artikel seit Abschluss des Abos. |
SubscriptionItemPriceChangeDetails
Informationen zu Preisänderungen eines Aboartikels.
JSON-Darstellung |
---|
{ "newPrice": { object ( |
Felder | |
---|---|
newPrice |
Neuer wiederkehrender Preis für das Abo. |
priceChangeMode |
Der Preisänderungsmodus gibt an, wie sich der Preis für das Abo ändert. |
priceChangeState |
Status der aktuellen Preisänderung. |
expectedNewPriceChargeTime |
Der Verlängerungszeitpunkt, zu dem die Preisänderung für den Nutzer in Kraft tritt. Dies kann sich ändern(zu einem späteren Zeitpunkt), 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 Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
PriceChangeMode
Der Modus der Preisänderung.
Enums | |
---|---|
PRICE_CHANGE_MODE_UNSPECIFIED |
Preisänderungsmodus nicht angegeben. Dieser Wert sollte nie festgelegt werden. |
PRICE_DECREASE |
Der Abopreis sinkt. |
PRICE_INCREASE |
Wenn sich der Abopreis erhöht und der Nutzer dem zustimmen muss. |
OPT_OUT_PRICE_INCREASE |
Der Abopreis steigt mit dem Deaktivierungsmodus. |
PriceChangeState
Der Status der Preisänderung.
Enums | |
---|---|
PRICE_CHANGE_STATE_UNSPECIFIED |
Preisänderungsstatus nicht angegeben. Dieser Wert sollte nicht verwendet werden. |
OUTSTANDING |
Es wird darauf gewartet, dass der Nutzer der Preisänderung zustimmt. |
CONFIRMED |
Es wird bestätigt, dass die Preisänderung für den Nutzer erfolgt. |
APPLIED |
Die Preisänderung wird angewendet, d.h., dem Nutzer wird der neue Preis in Rechnung gestellt. |
PrepaidPlan
Informationen zu einem Prepaid-Tarif.
JSON-Darstellung |
---|
{ "allowExtendAfterTime": string } |
Felder | |
---|---|
allowExtendAfterTime |
Falls vorhanden, ist dies der Zeitraum, nach dem Käufe für den Prepaid-Tarif aufladen können. Ist bei abgelaufenen Prepaid-Tarifen nicht vorhanden. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
OfferDetails
Angebotsdetails, die sich auf eine Kaufposition beziehen.
JSON-Darstellung |
---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
Felder | |
---|---|
offerTags[] |
Die neuesten Angebots-Tags, die mit dem Angebot verknüpft sind. Es enthält Tags, die aus dem Basis-Abo übernommen wurden. |
basePlanId |
Die Basis-Abo-ID. Für alle Basis-Abos und Angebote vorhanden. |
offerId |
Die Angebots-ID. Nur für ermäßigte Angebote verfügbar. |
DeferredItemReplacement
Informationen zum verzögerten Ersatz von Artikeln.
JSON-Darstellung |
---|
{ "productId": string } |
Felder | |
---|---|
productId |
Die productId, die die vorhandene productId ersetzt. |
Methoden |
|
---|---|
|
Metadaten zu einem Abo abrufen |
|
Sie können einen Abokauf für den Nutzer widerrufen. |