Method: subscriptions.insert

Crée ou transfère un abonnement.

Créez un abonnement pour le compte d'un client que vous avez commandé à l'aide de la méthode Commander un nouveau compte client. Pour en savoir plus sur la création d'un abonnement pour différents forfaits, consultez Gérer les abonnements.\

Si vous n'avez pas commandé le compte du client à l'aide de la méthode d'insertion du client, utilisez son customerAuthToken lorsque vous créez un abonnement pour ce client.

Si vous transférez un abonnement G Suite associé à un abonnement Google Drive ou Google Vault, utilisez l'opération groupée pour transférer l'ensemble de ces abonnements. Pour en savoir plus, découvrez comment transférer des abonnements.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Il peut s'agir du nom de domaine principal du client ou de son identifiant unique. Si le nom de domaine d'un client change, l'ancien nom de domaine ne peut pas être utilisé pour accéder au client, mais l'identifiant unique du client (tel que renvoyé par l'API) peut toujours être utilisé. Nous vous recommandons de stocker l'identifiant unique dans vos systèmes, le cas échéant.

Paramètres de requête

Paramètres
customerAuthToken

string

La chaîne de requête customerAuthToken est obligatoire lorsque vous créez un compte indirect qui transfère l'abonnement d'un client direct ou l'abonnement d'un autre client revendeur à votre gestion. Il s'agit d'un jeton d'authentification hexadécimal nécessaire pour finaliser le transfert d'abonnement. Pour en savoir plus, consultez le Centre d'aide pour les administrateurs.

Corps de la requête

Le corps de la requête contient une instance de Subscription.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Subscription.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez le Guide relatif aux autorisations.