Method: subscriptions.suspend

Ein aktives Abo wird pausiert.

Mit dieser Methode kannst du ein kostenpflichtiges Abo pausieren, das sich derzeit im Status ACTIVE befindet.

  • Bei FLEXIBLE-Abos wird die Abrechnung pausiert.
  • Für ANNUAL_MONTHLY_PAY- oder ANNUAL_YEARLY_PAY-Abos:
    • Durch die Sperrung des Abos ändert sich das ursprünglich vereinbarte Verlängerungsdatum nicht.
    • Ein gesperrtes Abo wird nicht verlängert. Wenn Sie das Abo nach dem ursprünglichen Verlängerungsdatum aktivieren, wird ein neues Jahresabo erstellt, das ab dem Tag der Aktivierung gilt.

Wir empfehlen Ihnen dringend, Abos nur für kurze Zeiträume zu pausieren, da eine Sperrung von mehr als 60 Tagen zur Kündigung des Abos führen kann.

HTTP-Anfrage

POST https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/suspend

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 muss leer sein.

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.