Method: subscriptions.changePlan

Aktualisiert einen Abotarif. Mit dieser Methode kannst du einen Tarif für eine 30-tägige Testphase oder einen flexiblen Tarif in einen Jahrestarif mit monatlichen oder jährlichen Zahlungen umwandeln.

Wie ein Plan aktualisiert wird, hängt vom Plan und den Produkten ab. Weitere Informationen finden Sie in der Beschreibung unter 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

Dies kann entweder der primäre Domainname des Kunden oder seine eindeutige Kennung sein. Wenn sich der Domainname eines Kunden ändert, kann der alte Domainname nicht mehr zum Zugriff auf den Kunden verwendet werden. Die eindeutige Kennung des Kunden (wie von der API zurückgegeben) kann jedoch immer verwendet werden. Wir empfehlen, die eindeutige Kennung gegebenenfalls in Ihren Systemen zu speichern.
subscriptionId

string

Dieses Attribut ist erforderlich. Die subscriptionId ist die Abo-ID und ist für jeden Kunden eindeutig. Da sich eine subscriptionId ändert, wenn ein Abo aktualisiert wird, empfehlen wir, diese ID nicht als Schlüssel für persistente Daten zu verwenden. Die subscriptionId kannst du mit der Methode Alle Reseller-Abos abrufen ermitteln.

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

Gibt an, dass die Ressource eine Anfrage zur Tarifänderung ist. Wert: subscriptions#changePlanRequest
planName

string

Das Attribut planName ist erforderlich. Das ist der Name des Preismodells des Abos. Weitere Informationen zu den Google-Zahlungsplänen finden Sie unter API-Konzepte.

Mögliche Werte:

  • ANNUAL_MONTHLY_PAY – Jahrestarif mit monatlicher Zahlung
  • ANNUAL_YEARLY_PAY – Jahrestarif mit jährlichen Zahlungen
  • FLEXIBLE – Flexibler Tarif
  • TRIAL – 30-tägiger kostenloser Testzeitraum

seats

object (Seats)

Dieses Attribut ist erforderlich. Die Property „seats“ ist die Anzahl der Nutzerlizenzen.
purchaseOrderId

string

Dieses Attribut ist optional. Diese Informationen zur Bestellung sind für Reseller zur Verwendung für das Tracking ihres Unternehmens bestimmt. Wenn ein purchaseOrderId-Wert angegeben ist, wird er in den API-Antworten und auf der Rechnung angezeigt. Das Attribut kann bis zu 80 Klartextzeichen enthalten.
dealCode

string

Von Google ausgestellter Code (maximal 100 Zeichen) für ermäßigte Preise für Abos. Der Angebotscode muss in der changePlan-Anfrage enthalten sein, damit der ermäßigte Preis gewährt werden kann. Dieses Attribut ist optional. Wenn einem Abo bereits ein Angebotscode hinzugefügt wurde, kann dieses Attribut leer bleiben. Der bestehende Rabattpreis wird dann weiterhin angewendet. Wenn das Attribut nicht leer ist, geben Sie nur den Angebotscode an, der bereits für das Abo vorhanden ist. Wenn einem Abo noch nie ein Angebotscode hinzugefügt wurde und dieses Attribut leer bleibt, gelten die regulären Preise.