Commander un nouveau compte client

Avant de créer un nouveau compte client, tenez compte des points suivants :

Créer un compte client

  1. Pour créer un compte client, utilisez la requête POST suivante et incluez le jeton d'autorisation :

    POST https://reseller.googleapis.com/apps/reseller/v1/customers

  2. Créez un utilisateur dans le compte du nouveau client, . Si la réponse renvoie un code d'état HTTP 409 Conflict, cela signifie que le customerId existe déjà. Avant d'enregistrer le compte client, vous devez transférer les abonnements du client.

  3. Le cas échéant, modifiez la langue par défaut du client.

  4. Attribuez le rôle de super-administrateur à l' utilisateur. Lorsque vous créez le compte administrateur, vous pouvez générer un mot de passe aléatoire temporaire ou demander au client de fournir un mot de passe.

  5. Indiquez au client qu'il doit se connecter à la console d'administration Google et signer le contrat Google Workspace pour les revendeurs afin d'activer son compte. Les revendeurs ne sont pas autorisés à signer les conditions d'utilisation au nom du client.

Types de clients

Vous pouvez créer deux types de clients dans Google Workspace :

  • Clients ayant validé leur domaine : ces clients ont besoin de Gmail et d'un accès administrateur complet. Lorsque vous créez ce type de client, définissez customerType sur domain.
  • Clients ayant validé leur adresse e-mail : ces clients ne possèdent ni ne gèrent leur domaine. Lorsque vous créez ce type de client, définissez customerType sur team. Ces clients peuvent acheter les éditions Google Workspace Essentials et Google Workspace Enterprise Essentials de Google Workspace.

Le corps de requête JSON suivant est un exemple de client ayant validé son domaine :

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Remplacez les éléments suivants :

  • DOMAIN_NAME: domaine du client, par exemple example.com.
  • NAME : nom du client, par exemple Alex Cruz.
  • ORGANIZATION_NAME: nom de l'organisation du client, par exemple Example Organization.
  • POSTAL_CODE: code postal du client, par exemple 94043.
  • COUNTRY_CODE : code pays ISO à deux caractères du client.
  • EMAIL_ADDRESS: adresse e-mail du client, par exemple cruz@example.com.

Une réponse positive renvoie un code d'état HTTP 200 et les informations du nouveau client :

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Le corps de requête JSON suivant est un exemple de client ayant validé son adresse e-mail :

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
 "alternateEmail": "EMAIL_ADDRESS"
}

Une réponse positive renvoie un code d'état HTTP 200 et les informations du nouveau client :

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME,
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Modifier la langue par défaut d'un client

La langue par défaut d'un client ne s'applique qu'aux nouveaux utilisateurs. Les utilisateurs existants conservent leur langue après la modification de la langue par défaut. Par conséquent, définissez la langue par défaut du client avant de créer des utilisateurs.

La langue par défaut d'un nouveau client est l'anglais. Pour modifier la langue par défaut, utilisez les PATCH ou UPDATE méthodes du point de terminaison Customers de l'API Directory.

Utilisez l'API Directory pour mettre à jour la valeur language par défaut d'un client :

PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID

Incluez le corps de requête JSON suivant :

{
  "language":"LANGUAGE_CODE"
}

Remplacez les éléments suivants :

Une réponse JSON positive renvoie un code d'état HTTP 200 et la ressource client mise à jour :

{
  "alternateEmail": "EMAIL_ADDRESS",
  "customerCreationTime": "2022-12-12T23:04:10.620Z",
  "customerDomain": "DOMAIN_NAME",
  "id": "CUSTOMER_ID",
  "kind": "admin#directory#customer",
  "language": "LANGUAGE_CODE",
  "postalAddress": {
    "contactName": "NAME",
    "countryCode": "COUNTRY_CODE",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE"
  }
}

Étapes suivantes