Créer ou transférer un abonnement

Après avoir commander le compte d'un client, vous pouvez créer différents abonnements:

  • 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 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' peuvent uniquement acheter Essentials et Éditions Enterprise Essentials de Google Workspace Si vous essayez d'acheter tout autre abonnement Google Workspace, vous bénéficiez Erreur : Customer is not eligible to purchase this subscription. Clients l'achat d'Essentials ou d'abonnements basés sur l'utilisation pourraient ne pas gérer Forfaits avec engagement annuel, et 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 est soit la le nom de domaine principal du client ou son identifiant unique renvoyé lorsque récupérer le compte d'un client indirect.

Créer un forfait avec engagement annuel

Pour les abonnements avec un forfait annuel, tous les SKU n'ont pas le même les paramètres de renouvellement par défaut. Nous vous recommandons de toujours transmettre renewalSettings. Créer un abonnement annuel avec engagement de 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: domaine principal du client ou l'identifiant unique du client.
  • SKU_ID: unité de gestion des stocks (SKU) unique identifiant. Pour en savoir plus, consultez Produits et ID SKU.
  • PURCHASE_ORDER_ID: bon de commande facultatif ID permettant de suivre l'utilisation.

Une réponse positive renvoie l'état HTTP 200 et l'état pour un forfait annuel. ANNUAL_MONTHLY_PAY est renvoyé en tant que 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: domaine principal du client ou l'identifiant unique du client.
  • SKU_ID: unité de gestion des stocks (SKU) unique identifiant. Pour en savoir plus, consultez Produits et ID SKU.
  • PURCHASE_ORDER_ID: bon de commande facultatif ID permettant de suivre l'utilisation.

Voici un exemple de réponse à 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 l'abonnement utilisez la requête HTTP POST suivante et incluez l'autorisation jeton:

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: domaine principal du client ou l'identifiant unique du client.
  • SKU_ID: unité de gestion des stocks (SKU) unique identifiant. Pour en savoir plus, consultez Produits et ID SKU.
  • PURCHASE_ORDER_ID: bon de commande facultatif ID permettant de 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 pour créer des abonnements à prix réduit taux de conversion. Pour appliquer une remise sur un abonnement, vous devez fournir le code d'offre dans l'appel insert de l'abonnement. Si le client change de sa SKU d'origine, la remise est supprimée.

Pour créer une remise sur l'abonnement avec engagement annuel compte du client, utilisez la requête HTTP POST suivante et incluez 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: domaine principal du client ou l'identifiant unique du client.
  • SKU_ID: unité de gestion des stocks (SKU) unique identifiant. Pour en savoir plus, consultez Produits et ID SKU.
  • PURCHASE_ORDER_ID: bon de commande facultatif ID permettant de suivre l'utilisation.
  • GOOGLE_CONTRACT_DEAL_CODE: un code de réduction disponible de 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 via le commander un nouveau compte client , utilisez le jeton de transfert du client lors de la création d'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: domaine principal du client ou l'identifiant unique du client.
  • TOKEN_VALUE: jeton de transfert fourni par votre client. Une fois que le client a généré le jeton, celui-ci est valide pendant 30 jours.

Pour savoir comment les clients obtiennent un jeton de transfert, consultez la Centre d'aide Google Workspace

Pour transférer l'abonnement d'un client bénéficiant d'un forfait avec engagement annuel, utilisez le 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: domaine principal du client ou l'identifiant unique du client.
  • SKU_ID: unité de gestion des stocks (SKU) unique identifiant. Pour en savoir plus, consultez Produits et ID SKU.
  • PURCHASE_ORDER_ID: bon de commande facultatif ID permettant de suivre l'utilisation.

Une réponse positive renvoie l'état HTTP 200. et les paramètres de l'abonnement transféré pour une 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 associé à un compte Google Drive ou Google Vault, utilisez le Opération batch pour transférer tous les abonnements dont l'état est ACTIVE. Transfert de chaque l'abonnement un par un entraîne une erreur.

Le transfert d'abonnements suspendus n'est autorisé que si le motif de la suspension est le suivant : 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 customervactually a été renvoyé en tant que transferInfo.currentLegacySkuId. Pour une 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 d'offre spéciale.