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 le pays du client est autorisé à revendre des produits, consultez la Partner Sales Console.
- Si le compte est créé en passant d'un compte Gmail personnel à une adresse e-mail professionnelle avec un nom de domaine, assurez-vous que des paramètres Google Workspace supplémentaires sont débloqués. Pour en savoir plus, consultez les articles 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
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
Dans le compte du nouveau client, créez un utilisateur. Si la réponse renvoie un code d'état HTTP
409 Conflict
, lecustomerId
existe déjà. Avant d'enregistrer le compte client, vous devez transférer ses abonnements.Le cas échéant, modifiez la langue par défaut du client.
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 temporaire aléatoire ou demander au client de fournir un mot de passe.
Précisez au client qu'il doit se connecter à la console d'administration et signer le contrat Google Workspace via le 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 dans Google Workspace:
- Clients dont le domaine a été validé Ces clients ont besoin de Gmail et d'un accès administrateur complet. Lorsque vous créez ce type de client, définissez
customerType
surdomain
. - Clients dont l'adresse e-mail a été validée Ces clients ne sont pas propriétaires ni gestionnaires de leur domaine. Lorsque vous créez ce type de client, définissez
customerType
surteam
. Ce type de clients peut 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,cruz@example.com
).
Une réponse réussie 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 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 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 n'est appliquée qu'aux nouveaux utilisateurs lors de leur création. Les utilisateurs existants conservent leur langue actuelle même après avoir modifié 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 client nouvellement créé 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 d'un client:
PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID
Incluez le corps de la 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" } }