- Ressource: SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- InstallmentPlan
- PendingCancellation
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- DeferredItemRemoval
- SignupPromotion
- OneTimeCode
- VanityCode
- Methoden
Ressource: SubscriptionPurchaseV2
Gibt den Status des Abokaufs eines Nutzers an.
JSON-Darstellung |
---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
Felder | |
---|---|
kind |
Dieser Typ stellt ein SubscriptionPurchaseV2-Objekt im androidpublisher-Dienst dar. |
regionCode |
ISO 3166-1 Alpha-2-Ländercode für das Abrechnungsland des Nutzers zum Zeitpunkt der Gewährung des Abos. |
lineItems[] |
Informationen auf Artikelebene für einen Abo-Kauf. 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 Abos festgelegt (das Abo wurde erstellt, die Zahlung bei der Registrierung steht aber noch aus). Verwendet RFC 3339. Die generierte Ausgabe wird immer Z-normalisiert und verwendet 0, 3, 6 oder 9 Nachkommastellen. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
subscriptionState |
Der aktuelle Status des Abos. |
latestOrderId |
Verworfen: Verwenden Sie stattdessen „lineItems.latest_successful_order_id“. Die Bestell-ID der letzten Bestellung, die mit dem Kauf des Abos verknüpft ist. Bei Abos mit automatischer Verlängerung ist dies die Bestell-ID der Registrierungsbestellung, wenn sie noch nicht verlängert wurde, oder die ID der letzten wiederkehrenden Bestellung (erfolgreiche, ausstehende oder abgelehnte Bestellung). Bei Prepaid-Abos ist dies die Bestell-ID, die mit dem abgefragten Kauf-Token verknüpft ist. |
linkedPurchaseToken |
Das Kauf-Token des alten Abos, wenn dieses Abo eines der folgenden ist: * Neuregistrierung eines gekündigten, aber nicht abgelaufenen Abos * Upgrade/Downgrade von einem vorherigen Abo. * Von einem Prepaid-Tarif zu einem Abo mit automatischer Verlängerung wechseln * Ein automatisch verlängertes Abo in ein Prepaid-Abo umwandeln * Prepaid-Abo aufladen |
pausedStateContext |
Zusätzlicher Kontext zu pausierten Abos. Nur vorhanden, wenn das Abo derzeit den subscriptionState SUBSCRIPTION_STATE_PAUSED hat. |
canceledStateContext |
Zusätzlicher Kontext zu gekündigten Abos. Nur vorhanden, wenn das Abo derzeit den subscriptionState SUBSCRIPTION_STATE_CANCELED oder SUBSCRIPTION_STATE_EXPIRED hat. |
testPurchase |
Wird nur angezeigt, wenn es sich bei diesem Abo-Kauf um einen Testkauf handelt. |
acknowledgementState |
Der Bestätigungsstatus des Abos. |
externalAccountIdentifiers |
Nutzerkonto-ID im Drittanbieterdienst. |
subscribeWithGoogleInfo |
Nutzerprofil, das mit Käufen verknüpft ist, die über „Abonnieren mit Google“ getätigt wurden. |
SubscriptionState
Die möglichen Status eines Abos, z. B. ob es aktiv oder gekündigt ist. Die Artikel in einem Abo-Kauf können entweder alle automatisch verlängerte Tarife oder Prepaid-Tarife sein.
Enums | |
---|---|
SUBSCRIPTION_STATE_UNSPECIFIED |
Nicht angegebener Abostatus. |
SUBSCRIPTION_STATE_PENDING |
Das Abo wurde erstellt, die Zahlung steht aber noch aus. In diesem Status warten alle Artikel auf die Zahlung. |
SUBSCRIPTION_STATE_ACTIVE |
Abonnement ist aktiv. – (1) Wenn es sich bei dem Abo um ein Abo mit automatischer Verlängerung 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 beim Abo um ein Abo mit automatischer Verlängerung 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 beim Abo um ein Abo mit automatischer Verlängerung handelt. In diesem Status befinden sich alle Artikel in der Kulanzfrist. |
SUBSCRIPTION_STATE_ON_HOLD |
Das Abo ist vorübergehend ausgesetzt. Der Status ist nur verfügbar, wenn es sich beim Abo um ein Abo mit automatischer Verlängerung handelt. In diesem Status werden alle Artikel zurückgehalten. |
SUBSCRIPTION_STATE_CANCELED |
Das Abo wurde gekündigt, ist aber noch nicht abgelaufen. Der Status ist nur verfügbar, wenn es sich beim Abo um ein Abo mit automatischer Verlängerung handelt. Für alle Artikel ist „autoRenewEnabled“ auf „false“ gesetzt. |
SUBSCRIPTION_STATE_EXPIRED |
Das Abo ist abgelaufen. Alle Elemente haben eine expiryTime in der Vergangenheit. |
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED |
Die ausstehende Transaktion für das Abo wurde storniert. Wenn es sich bei diesem ausstehenden Kauf um ein bestehendes Abo handelt, verwenden Sie „linkedPurchaseToken“, um den aktuellen Status dieses Abos abzurufen. |
PausedStateContext
Informationen zu einem pausierten Abo.
JSON-Darstellung |
---|
{ "autoResumeTime": string } |
Felder | |
---|---|
autoResumeTime |
Zeitpunkt, zu dem das Abo automatisch fortgesetzt wird. Verwendet RFC 3339. Die generierte Ausgabe wird immer Z-normalisiert und verwendet 0, 3, 6 oder 9 Nachkommastellen. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
CanceledStateContext
Informationen zu einem Abo im Status SUBSCRIPTION_STATE_CANCELED oder SUBSCRIPTION_STATE_EXPIRED.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld cancellation_reason . Der Grund für die Kündigung eines Abos. 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, z. B. aufgrund eines Abrechnungsproblems. |
developerInitiatedCancellation |
Das Abo wurde vom Entwickler gekündigt. |
replacementCancellation |
Das Abo wurde durch ein neues Abo ersetzt. |
UserInitiatedCancellation
Informationen zu Kündigungen, die von Nutzern initiiert wurden.
JSON-Darstellung |
---|
{
"cancelSurveyResult": {
object ( |
Felder | |
---|---|
cancelSurveyResult |
Informationen, die der Nutzer angibt, wenn er den Ablauf zum Kündigen des Abos abschließt (Umfrage zum Kündigungsgrund). |
cancelTime |
Der Zeitpunkt, zu dem das Abo vom Nutzer gekündigt wurde. Der Nutzer hat möglicherweise auch nach diesem Zeitraum noch Zugriff auf das Abo. Verwenden Sie „lineItems.expiry_time“, um festzustellen, ob ein Nutzer noch Zugriff hat. Verwendet RFC 3339. Die generierte Ausgabe wird immer Z-normalisiert und verwendet 0, 3, 6 oder 9 Nachkommastellen. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
CancelSurveyResult
Ergebnis der Kündigungs-Umfrage, wenn das Abo vom Nutzer gekündigt wurde.
JSON-Darstellung |
---|
{
"reason": enum ( |
Felder | |
---|---|
reason |
Der Grund, den der Nutzer in der Kündigungsumfrage ausgewählt hat. |
reasonUserInput |
Wird nur für CANCEL_SURVEY_REASON_OTHERS festgelegt. Das ist die Freitextantwort des Nutzers auf die Umfrage. |
CancelSurveyReason
Der Grund, den der Nutzer in der Kündigungsumfrage ausgewählt hat.
Enums | |
---|---|
CANCEL_SURVEY_REASON_UNSPECIFIED |
Der Grund für die Kündigung der Umfrage ist nicht angegeben. |
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE |
Das Abo wurde 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 |
Andere Gründe |
SystemInitiatedCancellation
Dieser Typ hat keine Felder.
Informationen zu Kündigungen, die vom Google-System initiiert wurden.
DeveloperInitiatedCancellation
Dieser Typ hat keine Felder.
Spezifische Informationen zu Stornierungen, die von Entwicklern initiiert wurden.
ReplacementCancellation
Dieser Typ hat keine Felder.
Informationen zu Kündigungen aufgrund eines Abo-Ersatzes.
TestPurchase
Dieser Typ hat keine Felder.
Gibt an, ob es sich bei diesem Abo-Kauf 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
Nutzerkonto-ID im Drittanbieterdienst.
JSON-Darstellung |
---|
{ "externalAccountId": string, "obfuscatedExternalAccountId": string, "obfuscatedExternalProfileId": string } |
Felder | |
---|---|
externalAccountId |
Nutzerkonto-ID im Drittanbieterdienst. Wird nur angezeigt, 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 Ihrer App verknüpft ist. Sie ist bei den folgenden Käufen vorhanden: * Wenn die Kontoverknüpfung im Rahmen des Abo-Kaufvorgangs 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 Ihrer App verknüpft ist. Nur vorhanden, wenn sie beim Kauf mit https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid angegeben wurde. |
SubscribeWithGoogleInfo
Informationen zu Käufen, die über „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 zum Zeitpunkt des Kaufs des Abos. |
profileName |
Der Profilname des Nutzers zum Zeitpunkt des Abo-Kaufs. |
emailAddress |
Die E‑Mail-Adresse des Nutzers zum Zeitpunkt des Abokaufs. |
givenName |
Der Vorname des Nutzers, als das Abo gekauft wurde. |
familyName |
Der Nachname des Nutzers zum Zeitpunkt des Aboabschlusses. |
SubscriptionPurchaseLineItem
Informationen auf Artikelebene für einen Abo-Kauf.
JSON-Darstellung |
---|
{ "productId": string, "expiryTime": string, "latestSuccessfulOrderId": string, // Union field |
Felder | |
---|---|
productId |
Die ID des gekauften Produkts, z. B. „monthly001“. |
expiryTime |
Zeitpunkt, zu dem das Abo abgelaufen ist oder abläuft, sofern der Zugriff nicht verlängert wird (z. B. durch Verlängerung). Verwendet RFC 3339. Die generierte Ausgabe wird immer Z-normalisiert und verwendet 0, 3, 6 oder 9 Nachkommastellen. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
latestSuccessfulOrderId |
Die Bestell-ID der letzten erfolgreichen Bestellung, die mit diesem Artikel verknüpft ist. Nicht vorhanden, wenn der Artikel noch nicht dem Nutzer gehört (z.B. wenn der Artikel durch einen anderen Artikel ersetzt wird). |
Union-Feld plan_type . Der Typ des Abos. 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 für ein Element eine verzögerte Änderung vorliegt. Sie kann entweder entfernt oder ersetzt werden. Für deferred_item_change ist nur einer der folgenden Werte zulässig: |
|
deferredItemReplacement |
Informationen zum Ersatz zurückgestellter Artikel. |
deferredItemRemoval |
Informationen zum verzögerten Entfernen von Elementen. |
signupPromotion |
Angebotsdetails zu diesem Artikel. Wird nur festgelegt, wenn bei der Registrierung eine Werbeaktion angewendet wurde. |
AutoRenewingPlan
Informationen zu einem Abo mit automatischer Verlängerung.
JSON-Darstellung |
---|
{ "autoRenewEnabled": boolean, "recurringPrice": { object ( |
Felder | |
---|---|
autoRenewEnabled |
Wenn das Abo derzeit auf automatische Verlängerung eingestellt ist, z.B. weil der Nutzer das Abo nicht gekündigt hat |
recurringPrice |
Der aktuelle wiederkehrende Preis des Abos mit automatischer Verlängerung. Der Preis berücksichtigt keine Rabatte und enthält bei Preisen ohne Steuern keine Steuern. Rufen Sie stattdessen die |
priceChangeDetails |
Informationen zur letzten Preisänderung für das Element seit der Registrierung für das Abo. |
installmentDetails |
Die Zusicherung für den Ratenzahlungsplan und zugehörige Informationen zum Abo mit automatischer Verlängerung. |
SubscriptionItemPriceChangeDetails
Informationen zu Preisänderungen für einen Aboposten.
JSON-Darstellung |
---|
{ "newPrice": { object ( |
Felder | |
---|---|
newPrice |
Neuer wiederkehrender Preis für das Abo-Element. |
priceChangeMode |
Der Preisänderungsmodus gibt an, wie sich der Preis des Abo-Artikels ändert. |
priceChangeState |
Geben Sie an, in welcher Phase sich die Preisänderung gerade befindet. |
expectedNewPriceChargeTime |
Der Zeitpunkt der Verlängerung, zu dem die Preisänderung für den Nutzer wirksam wird. Dies kann sich in Zukunft ändern, z. B. wenn sich die Verlängerungszeit durch eine Pausierung verschiebt. Dieses Feld wird nur ausgefüllt, wenn die Preisänderung noch nicht in Kraft getreten ist. Verwendet RFC 3339. Die generierte Ausgabe wird immer Z-normalisiert und verwendet 0, 3, 6 oder 9 Nachkommastellen. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
PriceChangeMode
Der Modus der Preisänderung.
Enums | |
---|---|
PRICE_CHANGE_MODE_UNSPECIFIED |
Der Modus der Preisänderung ist nicht angegeben. Dieser Wert sollte nie festgelegt werden. |
PRICE_DECREASE |
Wenn der Abopreis sinkt. |
PRICE_INCREASE |
Wenn der Abopreis steigt und der Nutzer der Preiserhöhung zustimmen 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 |
Der Status der Preisänderung ist nicht angegeben. Dieser Wert sollte nicht verwendet werden. |
OUTSTANDING |
Warten darauf, dass der Nutzer der Preisänderung zustimmt. |
CONFIRMED |
Die Preisänderung wird für den Nutzer bestätigt. |
APPLIED |
Die Preisänderung wurde 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, die der Nutzer anfangs zugesagt hat. |
subsequentCommittedPaymentsCount |
Gesamtzahl der Zahlungen, die der Nutzer nach jedem Verpflichtungszeitraum leisten muss. Wenn das Feld leer ist, wird das Abo nach der Mindestlaufzeit automatisch als normales Abo mit automatischer Verlängerung verlängert. |
remainingCommittedPaymentsCount |
Die Gesamtzahl der verbleibenden zugesagten Zahlungen, die in diesem Verlängerungszyklus noch zu zahlen sind. |
pendingCancellation |
Falls vorhanden, wird dieser Ratenplan demnächst storniert. Die Kündigung erfolgt erst, nachdem der Nutzer alle zugesagten Zahlungen geleistet hat. |
PendingCancellation
Dieser Typ hat keine Felder.
Gibt an, ob für den virtuellen Ratenzahlungsplan eine ausstehende Kündigung vorliegt. Die Kündigung erfolgt erst, nachdem der Nutzer alle zugesagten Zahlungen geleistet hat.
PrepaidPlan
Informationen zu einem Prepaid-Tarif.
JSON-Darstellung |
---|
{ "allowExtendAfterTime": string } |
Felder | |
---|---|
allowExtendAfterTime |
Falls vorhanden, ist dies der Zeitpunkt, ab dem Aufladekäufe für den Prepaid-Tarif zulässig sind. Bei abgelaufenen Prepaid-Mitgliedschaften nicht vorhanden. Verwendet RFC 3339. Die generierte Ausgabe wird immer Z-normalisiert und verwendet 0, 3, 6 oder 9 Nachkommastellen. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
OfferDetails
Informationen zu Angebotsdetails für eine Kaufposition.
JSON-Darstellung |
---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
Felder | |
---|---|
offerTags[] |
Die neuesten Angebots-Tags, die mit dem Angebot verknüpft sind. Sie enthält Tags, die vom Basisplan übernommen wurden. |
basePlanId |
Die ID des Basis-Abos. Für alle Basis-Abos und Angebote verfügbar. |
offerId |
Die Angebots-ID. Wird nur für Angebote mit Rabatt angezeigt. |
DeferredItemReplacement
Informationen zum verzögerten Ersatz von Artikeln.
JSON-Darstellung |
---|
{ "productId": string } |
Felder | |
---|---|
productId |
Die productId, die die vorhandene productId ersetzen soll. |
DeferredItemRemoval
Dieser Typ hat keine Felder.
Informationen zum verzögerten Ersatz von Artikeln.
SignupPromotion
Die beim Kauf auf diesen Artikel angewendete Werbeaktion.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld promotion_type . Die Art der Werbung, die auf den Artikel angewendet wird. Für promotion_type ist nur einer der folgenden Werte zulässig: |
|
oneTimeCode |
Ein Einmalcode wurde angewendet. |
vanityCode |
Ein Vanity-Code wurde angewendet. |
OneTimeCode
Dieser Typ hat keine Felder.
Ein Gutscheincode für einmaligen Gebrauch.
VanityCode
Ein vordefinierter Gutscheincode, der mehrmals verwendet werden kann.
JSON-Darstellung |
---|
{ "promotionCode": string } |
Felder | |
---|---|
promotionCode |
Der Gutscheincode. |
Methoden |
|
---|---|
|
Metadaten zu einem Abo abrufen |
|
Widerrufen Sie den Abokauf für den Nutzer. |