Commander un nouveau compte client

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

• Des restrictions liées au code pays peuvent s'appliquer. Pour vérifier que la revente est autorisée dans le pays du client, accédez à la Partner Sales Console.
• Si le compte a été créé en passant d'un compte Gmail personnel à une adresse e-mail professionnelle avec un nom de domaine, assurez-vous que les paramètres Google Workspace supplémentaires sont déverrouillés pour ce compte. Pour en savoir plus, consultez Créer des adresses e-mail professionnelles pour votre équipe et Créer un alias d'adresse e-mail professionnelle.

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. Dans le compte du nouveau client, créez un utilisateur. Si la réponse renvoie un code d'état HTTP 409 Conflict, l'élément 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. Lors de la création du compte administrateur, vous pouvez soit générer un mot de passe aléatoire temporaire, soit inviter le client à en fournir un.

5. Indiquez au client qu'il doit se connecter à la console d'administration et signer le contrat Google Workspace via le contrat Revendeur pour 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 sur Google Workspace:

• Clients dont le domaine a été validé : Ces clients ont besoin d'un accès administrateur complet. Lorsque vous créez ce type de client, définissez customerType sur domain.
• Clients dont l'adresse e-mail a été validée : 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 types de clients peuvent acheter les éditions Essentials et Enterprise Essentials de Google Workspace.

Le corps de requête JSON suivant est un exemple de client dont le domaine a été validé:

{
  "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 de votre client (par exemple, example.com)
• NAME: nom de votre client (par exemple, Alex Cruz).
• ORGANIZATION_NAME: nom de l'organisation de votre client (par exemple, Example Organization).
• POSTAL_CODE: code postal de votre client (par exemple, 94043).
• COUNTRY_CODE: code pays ISO à deux caractères de votre client.
• EMAIL_ADDRESS: adresse e-mail de votre client (par exemple, [e-mail]).

Une réponse réussie renvoie un code d'état HTTP 200 et les informations sur le 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 dont l'adresse e-mail a été validée:

{
  "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 réussie renvoie un code d'état HTTP 200 et les informations sur le 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 n'est appliquée qu'aux nouveaux utilisateurs lors de sa création. Les utilisateurs existants conservent la langue actuelle, même après avoir mis à jour la langue par défaut. Par conséquent, vous devez définir 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 appels PATCH ou UPDATE à partir du point de terminaison Clients de l'API Directory.

Utilisez l'API Directory pour mettre à jour la valeur language par défaut pour 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 :

• CUSTOMER_ID: identifiant unique de votre client (par exemple, C0123456)
• LANGUAGE_CODE: code de langue accepté, par exemple es pour l'espagnol.

Une réponse JSON réussie 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

• Erreurs courantes de l'API Reseller
• Erreurs courantes dans l'API Directory