Après avoir commandé le compte d'un client, vous pouvez créer plusieurs abonnements différents:
- Un abonnement avec engagement annuel
- Un abonnement flexible
- Essai sans frais de 30 jours
- Un abonnement à prix réduit
Pour en savoir plus sur les produits utilisés par ces abonnements, consultez la page Produits et SKU.
Si vous n'avez pas commandé le compte de ce client, vous pouvez transférer un abonnement.
Les clients disposant de customerType = 'team' ne peuvent acheter que les éditions Essentials et Enterprise Essentials de Google Workspace. Si vous essayez d'acheter l'un des autres abonnements Google Workspace, l'erreur Customer is not eligible to purchase this subscription s'affiche. Il est possible que les clients qui achètent des abonnements Essentials ou basés sur l'utilisation ne puissent pas gérer les forfaits avec engagement annuel, et que leurs options de passage à un forfait supérieur ou inférieur sont limitées.
Créer un abonnement
Pour créer un abonnement pour le compte d'un nouveau client, utilisez la requête HTTP POST suivante et incluez le jeton d'autorisation:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
Le champ CUSTOMER_ID correspond au nom de domaine principal du client ou à l'identifiant unique du client, renvoyé lors de la récupération du compte d'un client indirect.
Créer un forfait avec engagement annuel
Pour les abonnements à un forfait avec engagement annuel, tous les SKU n'ont pas les mêmes paramètres de renouvellement par défaut. Nous vous recommandons de toujours transmettre renewalSettings. Créez un abonnement avec engagement annuel avec 10 licences utilisateur:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
renewalSettings: {
"renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Remplacez les éléments suivants :
CUSTOMER_ID: nom de domaine principal du client ou identifiant unique du client.SKU_ID: identifiant unique de l'unité de gestion des stocks (SKU). Pour en savoir plus, consultez la page Identifiants de produits et de SKU.PURCHASE_ORDER_ID: ID de bon de commande facultatif que vous pouvez utiliser pour suivre l'utilisation.
Une réponse réussie renvoie l'état HTTP 200 et les paramètres du nouvel abonnement pour un forfait annuel. ANNUAL_MONTHLY_PAY est renvoyé sous la forme ANNUAL dans toutes les réponses de l'API.
Voici un exemple de réponse à un forfait annuel:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Créer un forfait modulable
Pour créer un abonnement flexible pour le compte d'un nouveau client, utilisez la requête HTTP POST suivante et incluez le jeton d'autorisation:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "FLEXIBLE"
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Remplacez les éléments suivants :
CUSTOMER_ID: nom de domaine principal du client ou identifiant unique du client.SKU_ID: identifiant unique de l'unité de gestion des stocks (SKU). Pour en savoir plus, consultez la page Identifiants de produits et de SKU.PURCHASE_ORDER_ID: ID de bon de commande facultatif que vous pouvez utiliser pour suivre l'utilisation.
Voici un exemple de réponse pour un forfait modulable:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "FLEXIBLE",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": false
},
"purchaseOrderId": "my_example_flex_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Créer un essai sans frais
Pour créer un abonnement d'essai sans frais de 30 jours pour le compte d'un nouveau client, utilisez la requête HTTP POST suivante et incluez le jeton d'autorisation:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "TRIAL"
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Remplacez les éléments suivants :
CUSTOMER_ID: nom de domaine principal du client ou identifiant unique du client.SKU_ID: identifiant unique de l'unité de gestion des stocks (SKU). Pour en savoir plus, consultez la page Identifiants de produits et de SKU.PURCHASE_ORDER_ID: ID de bon de commande facultatif que vous pouvez utiliser pour suivre l'utilisation.
Voici un exemple de réponse à un forfait d'essai sans frais de 30 jours:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "TRIAL",
"isCommitmentPlan": false
},
"seats": {
"kind": "subscriptions#seats",
"maximumNumberOfSeats": 10,
"licensedNumberOfSeats": 0
},
"trialSettings": {
"isInTrial": true,
"trialEndTime": "1331648420142"
},
"purchaseOrderId": "my_example_trial_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"skuName": "Google Workspace Business Standard"
}
Créer un abonnement avec remise
Google peut fournir un code d'offre permettant de créer des abonnements à prix réduit. Pour proposer une remise sur un abonnement, vous devez fournir le code d'offre dans l'appel insert de l'abonnement. Si le client change de code SKU d'origine, la remise est supprimée.
Pour créer une remise sur l'abonnement avec engagement annuel pour le compte d'un nouveau client, utilisez la requête HTTP POST suivante et incluez le jeton d'autorisation:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions
{
"kind": "reseller#subscription",
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10
},
renewalSettings: {
"renewalType": 'RENEW_CURRENT_USERS_MONTHLY_PAY'
},
"purchaseOrderId": "PURCHASE_ORDER_ID",
"dealCode": "GOOGLE_CONTRACT_DEAL_CODE"
}
Remplacez les éléments suivants :
CUSTOMER_ID: nom de domaine principal du client ou identifiant unique du client.SKU_ID: identifiant unique de l'unité de gestion des stocks (SKU). Pour en savoir plus, consultez la page Identifiants de produits et de SKU.PURCHASE_ORDER_ID: ID de bon de commande facultatif que vous pouvez utiliser pour suivre l'utilisation.GOOGLE_CONTRACT_DEAL_CODE: code de réduction proposé par Google.
Voici un exemple de réponse à un forfait annuel avec remise:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "my_example.com_annual_1",
"status": "ACTIVE",
"customerDomain": "my_example.com",
"dealCode": "GOOGLE_CONTRACT_DEAL_CODE",
"skuName": "Google Workspace Business Standard"
}
Transférer un abonnement
Si vous n'avez pas commandé le compte du client à l'aide de l'opération Commander un nouveau compte client, utilisez le jeton de transfert du client lors de la création de l'abonnement de ce client.
Pour créer un abonnement pour un compte client que vous n'avez pas commandé, utilisez la requête HTTP POST suivante:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID/subscriptions?customerAuthToken=TOKEN_VALUE
Remplacez les éléments suivants :
CUSTOMER_ID: nom de domaine principal du client ou identifiant unique du client.TOKEN_VALUE: jeton de transfert fourni par votre client. Une fois que le client a généré le jeton, il est valable 30 jours.
Pour savoir comment les clients obtiennent un jeton de transfert, consultez le Centre d'aide Google Workspace.
Pour transférer l'abonnement d'un client disposant d'un forfait avec engagement annuel, utilisez la requête HTTP POST suivante et incluez le jeton d'autorisation:
POST https://reseller.googleapis.com/apps/reseller/v1/customers/C0123456/subscriptions?customerAuthToken=auth token
{
"customerId": "CUSTOMER_ID",
"skuId": "SKU_ID",
"plan": {
"planName": "ANNUAL_MONTHLY_PAY"
},
"seats": {
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"purchaseOrderId": "PURCHASE_ORDER_ID"
}
Remplacez les éléments suivants :
CUSTOMER_ID: nom de domaine principal du client ou identifiant unique du client.SKU_ID: identifiant unique de l'unité de gestion des stocks (SKU). Pour en savoir plus, consultez la page Identifiants de produits et de SKU.PURCHASE_ORDER_ID: ID de bon de commande facultatif que vous pouvez utiliser pour suivre l'utilisation.
Une réponse réussie renvoie un code d'état HTTP 200 et les paramètres de l'abonnement transféré pour un forfait avec engagement annuel:
{
"kind": "reseller#subscription",
"customerId": "C0123456",
"subscriptionId": "123",
"billingMethod": "ONLINE",
"skuId": "1010020028",
"creationTime": "1331647980142",
"plan": {
"planName": "ANNUAL",
"isCommitmentPlan": true,
"commitmentInterval": {
"startTime": "1331647980142",
"endTime": "1363183980142"
}
},
"seats": {
"kind": "subscriptions#seats",
"numberOfSeats": 10,
"licensedNumberOfSeats": 10
},
"trialSettings": {
"isInTrial": false
},
"renewalSettings": {
"kind": "subscriptions#renewalSettings",
"renewalType": "SWITCH_TO_PAY_AS_YOU_GO"
},
"purchaseOrderId": "example.com_annual_1",
"status": "ACTIVE",
"resourceUiUrl": "URL to customer's Admin console dashboard",
"skuName": "Google Workspace Business Standard"
}
Limites de transfert
Si vous transférez un abonnement Google Workspace associé à un abonnement Google Drive ou Google Vault, utilisez l'opération batch pour transférer tous les abonnements dont l'état est ACTIVE. Le transfert de chaque abonnement un par un génère une erreur.
Le transfert d'abonnements suspendus n'est autorisé que si le motif de la suspension est PENDING_TOS_ACCEPTANCE, TRIAL_ENDED ou RENEWAL_WITH_TYPE_CANCEL.
Lors du transfert d'un ancien SKU, subscriptions.list renvoie un skuId du SKU à transférer. Le skuId du SKU reçu par le client est renvoyé en tant que transferInfo.currentLegacySkuId. Pour obtenir la liste complète des skuIds et des produits utilisés par ces forfaits, consultez Produits et SKU.
Les transferts ne fonctionnent pas avec les codes de réduction.