Method: subscriptions.suspend

Sperrt ein aktives Abo.

Mit dieser Methode können Sie ein kostenpflichtiges Abo sperren, das sich derzeit im Status ACTIVE befindet.

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

Wir empfehlen Ihnen dringend, Abos nur für kurze Zeit zu sperren, 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

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 mehr für den Zugriff auf den Kunden verwendet werden. Es kann jedoch immer die eindeutige ID des Kunden (die von der API zurückgegeben wird) 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 darf für jeden Kunden nur einmal vorkommen. Da sich subscriptionId ändert, wenn ein Abo aktualisiert wird, empfehlen wir, diese ID nicht als Schlüssel für persistente Daten zu verwenden. Die subscriptionId kann mit der Methode Alle Reseller-Abos abrufen abgerufen werden.

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.