Aktualisiert ein Abo. Mit dieser Methode können Sie einen Tarif für einen 30-tägigen Testzeitraum oder einen flexiblen Tarif mit einem Jahrestarif mit monatlichen oder jährlichen Zahlungen aktualisieren.
Wie ein Plan aktualisiert wird, hängt vom Tarif und den Produkten ab. Weitere Informationen finden Sie in der Beschreibung zu Abos verwalten.
HTTP-Anfrage
POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan
Das kann entweder der primäre Domainname des Kunden oder die eindeutige Kennung des Kunden sein. Wenn sich der Domainname für einen Kunden ändert, kann der alte Domainname nicht für den Zugriff auf den Kunden verwendet werden. Die eindeutige Kennung des Kunden, die von der API zurückgegeben wird, kann jedoch immer verwendet werden. Wir empfehlen, die eindeutige Kennung gegebenenfalls in Ihren Systemen zu speichern.
subscriptionId
string
Dies ist eine erforderliche Property. Die subscriptionId ist die Abo-ID und für jeden Kunden eindeutig. Da sich subscriptionId bei der Aktualisierung eines Abos ändert, empfehlen wir, diese ID nicht als Schlüssel für persistente Daten zu verwenden. Die subscriptionId kann mit der Methode Alle Reseller-Abos abrufen ermittelt werden.
Kennzeichnet die Ressource als Anfrage für einen Aboänderungsplan. Wert: subscriptions#changePlanRequest
planName
string
Das Attribut planName ist erforderlich. Dies ist der Name des Abrechnungsmodells für das Abo. Weitere Informationen zu den Google-Preismodellen finden Sie unter API-Konzepte.
Mögliche Werte sind:
ANNUAL_MONTHLY_PAY: Jahrestarif mit monatlichen Zahlungen
ANNUAL_YEARLY_PAY: Jahrestarif mit jährlichen Zahlungen
Dies ist eine erforderliche Property. Die Eigenschaft „Sitz“ ist die Anzahl der Nutzerlizenzen.
purchaseOrderId
string
Dies ist eine optionale Eigenschaft. Diese Auftragsinformationen können Reseller für die Tracking-Nutzung ihres Unternehmens verwenden. Wenn ein purchaseOrderId-Wert angegeben wird, erscheint dieser in den API-Antworten und auf der Rechnung. Die Eigenschaft akzeptiert bis zu 80 Textzeichen.
dealCode
string
Von Google vergebener Code (max. 100 Zeichen) für Rabatte auf Abos. Damit Sie den Rabatt erhalten, muss der Deal-Code in der changePlan-Anfrage enthalten sein. Dieses Attribut ist optional. Wenn einem Abo bereits ein Deal-Code hinzugefügt wurde, kann diese Property leer bleiben und der vorhandene rabattierte Preis gilt weiterhin. Wenn das Feld nicht leer ist, gib nur den Deal-Code an, der im Abo bereits vorhanden ist. Wenn einem Abo noch kein Deal-Code hinzugefügt wurde und diese Eigenschaft leer gelassen wird, gelten die regulären Preise.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2024-09-09 (UTC)."],[[["Updates a subscription's plan, allowing changes from trial or flexible plans to annual commitments with monthly or yearly payments, with varying update processes based on the specific plan and products."],["Requires sending a POST request to a specific URL, including the `customerId` and `subscriptionId` as path parameters."],["The request body must contain a `ChangePlanRequest` object specifying the desired plan name, number of seats, and optional purchase order ID and deal code."],["Successful responses return a `Subscription` object representing the updated subscription."],["Requires authorization with the `https://www.googleapis.com/auth/apps.order` scope."]]],[]]