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 plus d'informations 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, effectuez l'opération groupée pour transférer tous 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 ou de l'identifiant unique du client. Si le nom de domaine d'un client change, l'ancien nom de domaine ne peut plus ê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 conserver 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 requise lorsque vous créez un compte indirect qui transfère l'abonnement d'un client direct ou l'abonnement d'un autre client revendeur sous votre gestion. Il s'agit d'un jeton d'authentification hexadécimal nécessaire pour finaliser le transfert de l'abonnement. Pour plus d'informations, consultez le Centre d'aide pour les administrateurs.

Corps de la requête

Le corps de la requête contient une instance 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.