Method: subscriptions.insert

Ein Abo wird erstellt oder übertragen.

Erstellen Sie ein Abo für das Konto eines Kunden, das Sie mit der Methode Neues Kundenkonto bestellen bestellt haben. Weitere Informationen zum Erstellen von Abos für verschiedene Preismodelle finden Sie unter Abos verwalten.

Wenn du das Konto des Kunden nicht mit der Einfügemethode bestellt hast, verwende die customerAuthToken des Kunden, wenn du ein Abo für diesen Kunden erstellst.

Wenn Sie ein G Suite-Abo mit einem verknüpften Google Drive- oder Google Vault-Abo übertragen möchten, können Sie alle diese Abos per Batchvorgang übertragen. Weitere Informationen findest du unter Abos übertragen.

HTTP-Anfrage

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

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.

Abfrageparameter

Parameter
customerAuthToken

string

Der Abfragestring customerAuthToken ist erforderlich, wenn Sie ein weiterverkauftes Konto erstellen, mit dem das Abo eines Direktkunden oder das Abo eines anderen Reseller-Kunden an Ihre Reseller-Verwaltung übertragen wird. Dies ist ein hexadezimales Authentifizierungstoken, das für die Aboübertragung erforderlich ist. Weitere Informationen finden Sie in der Hilfe für Administratoren.

Anfragetext

Der Anfragetext enthält eine Instanz von Subscription.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Subscription.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.