Créer ou transférer un abonnement

Une fois que vous avez commandé le compte d'un client, vous pouvez créer différents types d'abonnements :

  • Abonnement avec engagement annuel
  • Abonnement flexible
  • Essai sans frais de 30 jours
  • 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 du client, vous pouvez transférer un abonnement.

Les clients dont le customerType = 'team' ne peuvent acheter que les éditions Google Workspace Essentials et Google Workspace Enterprise Essentials de Google Workspace. Si vous essayez d'acheter d'autres abonnements Google Workspace, l'erreur suivante s'affiche : Customer is not eligible to purchase this subscription (Le client n'est pas autorisé à acheter cet abonnement). Les clients qui achètent des abonnements Essentials ou basés sur l'utilisation ne peuvent pas utiliser les forfaits avec engagement annuel et disposent d'options limitées pour passer à un forfait supérieur ou inférieur.

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 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 avec engagement annuel

Pour les abonnements avec 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 :

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 son identifiant unique.
  • SKU_ID: identifiant unique de l'unité de gestion des stocks (SKU). Pour en savoir plus, consultez la section Produits et ID 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 état HTTP 200 et les paramètres du nouvel abonnement pour un forfait avec engagement annuel. ANNUAL_MONTHLY_PAY est renvoyé en tant que 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 forfait 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 son identifiant unique.
  • SKU_ID: identifiant unique de l'unité de gestion des stocks (SKU). Pour en savoir plus, consultez la section Produits et ID 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 son identifiant unique.
  • SKU_ID: identifiant unique de l'unité de gestion des stocks (SKU). Pour en savoir plus, consultez la section Produits et ID 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 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 à prix réduit

Google peut fournir un code promotionnel pour créer des abonnements à prix réduit. Pour appliquer une remise à un abonnement, vous devez fournir le code promotionnel dans l'appel insert de l'abonnement. Si le client modifie son SKU d'origine, la remise est supprimée.

Pour créer un abonnement avec engagement annuel à prix réduit 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 son identifiant unique.
  • SKU_ID: identifiant unique de l'unité de gestion des stocks (SKU). Pour en savoir plus, consultez la section Produits et ID 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 fourni par Google.

Voici un exemple de réponse pour un forfait annuel à prix réduit :

{
  "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 de commande d'un nouveau 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 son identifiant unique.
  • TOKEN_VALUE: jeton de transfert fourni par votre client. Une fois généré par le client, le jeton est valide pendant 30 jours.

Pour en savoir plus sur la façon dont les clients obtiennent un jeton de transfert, consultez le Centre d'aide de l'administrateur.

Pour transférer l'abonnement d'un client avec 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 son identifiant unique.
  • SKU_ID: identifiant unique de l'unité de gestion des stocks (SKU). Pour en savoir plus, consultez la section Produits et ID 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 avec un abonnement Google Drive ou Google Vault associé, utilisez l'opération batch pour transférer tous les abonnements avec l'état ACTIVE. Le transfert de chaque abonnement un par un génère une erreur.

Le transfert des 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 SKU hérité, subscriptions.list renvoie un skuId du SKU à transférer. Le skuId du SKU dont dispose réellement 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 la section Produits et SKU.

Les transferts ne fonctionnent pas avec les codes promotionnels.