Une fois que vous avez commandé le compte d'un client, vous pouvez créer plusieurs abonnements différents:
- Un abonnement avec engagement annuel
- Un abonnement flexible
- Un 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 section 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. Les clients qui souscrivent des abonnements Essentials ou basés sur l'utilisation ne peuvent pas forcément gérer les forfaits annuels et ont des options de mise à niveau et de rétrogradation 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
CUSTOMER_ID correspond au nom de domaine principal du client ou à son identifiant unique renvoyé lors de la récupération du compte d'un client revendu.
Créer un forfait annuel
Pour les abonnements 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 de 10 places:
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 section ID 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 positive renvoie un é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 pour 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 plan flexible
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 section ID 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 flexible:
{
"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 section ID 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 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 vous fournir un code promotionnel pour créer des abonnements à un tarif réduit. Pour appliquer une remise à un abonnement, vous devez fournir le code d'offre dans l'appel insert de l'abonnement. Si le client change de SKU d'origine, la remise est supprimée.
Pour créer un abonnement avec engagement annuel avec remise 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 section ID 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 disponible sur Google.
Voici un exemple de réponse pour 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 compte client, utilisez le jeton de transfert du client lorsque vous créez un abonnement pour 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 valide pendant 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 avec un forfait 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 section ID 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 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 avec un abonnement Google Drive ou Google Vault associé, utilisez l'opération batch pour transférer tous les abonnements dont l'état est ACTIVE. Le transfert de chaque abonnement individuellement génère une erreur.
Le transfert d'abonnements suspendus n'est autorisé que si la raison 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 que le client possède réellement est renvoyé en tant que transferInfo.currentLegacySkuId. Pour obtenir la liste complète des skuIds et des produits utilisés par ces forfaits, consultez la section Produits et SKU.
Les transferts ne fonctionnent pas avec les codes de réduction.