Method: subscriptions.changePlan

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

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.

Anfragetext

Der Anfragetext enthält eine Instanz von ChangePlanRequest.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Subscription.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/apps.order

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

ChangePlanRequest

JSON-Vorlage für die RPC-Anfrage "subscriptions.changePlan".

JSON-Darstellung
{
  "kind": string,
  "planName": string,
  "seats": {
    object (Seats)
  },
  "purchaseOrderId": string,
  "dealCode": string
}
Felder
kind

string

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
  • FLEXIBLE – der flexible Tarif
  • TRIAL: die 30-tägige kostenlose Testversion

seats

object (Seats)

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.