Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Avant de créer un compte client, tenez compte des points suivants :
Des restrictions de code pays peuvent s'appliquer. Pour vérifier que le pays du client est autorisé pour la revente, consultez la Partner Sales Console.
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 nouveau compte client, créez un utilisateur.
Si la réponse renvoie un code d'état HTTP 409 Conflict, cela signifie que customerId existe déjà. Avant d'enregistrer le compte client, vous devez transférer ses abonnements.
Indiquez au client qu'il doit se connecter à la console d'administration et signer le contrat Google Workspace via un 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 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 est validé :
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 la modification de 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 Customers de l'API Directory.
Utilisez l'API Directory pour mettre à jour la valeur language par défaut d'un client :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/29 (UTC)."],[],[],null,["# Order a new customer account\n\nBefore you create a new customer account, consider the following:\n\n- Country code restrictions might apply. To confirm that the customer's country is approved for resale, check [the Partner Sales Console](https://channelservices.cloud.google.com/).\n- If the account is created by upgrading from a consumer Gmail account to a business email with a domain name, make sure that the account has additional Google Workspace settings unlocked. For more information, see [Create business emails for your team](https://support.google.com/work/mail/faq/6233331#6241806) and [Create a business email alias](https://support.google.com/work/mail/faq/6233331#6243069).\n\nCreate a customer account\n-------------------------\n\n1. To create a customer account, use the following `POST` request and\n include the authorization token:\n\n POST https://reseller.googleapis.com/apps/reseller/v1/customers\n\n2. Within the new customer's account,\n [create a user](/workspace/admin/directory/v1/guides/manage-users#create_user).\n If the response returns an HTTP `409 Conflict` status code, the\n `customerId` already exists. Before registering the customer account, you must\n [transfer the customer's subscriptions](/workspace/admin/reseller/v1/how-tos/manage_subscriptions#transfer_a_subscription).\n\n3. If applicable, [change the customer's default launguage](#change_a_customers_default_language).\n\n4. Promote the\n [user to the super administrator role](/workspace/admin/directory/v1/guides/manage-users#make_admin).\n When creating the administrator account, you can either generate a temporary\n random password or prompt the customer to provide a password.\n\n5. Notify the customer that they must sign-in to the Admin console and\n sign the Google Workspace via Reseller agreement in order to activate\n their account. Resellers are prohibited from signing the Terms of Service on\n the customer's behalf.\n\n### Types of customers\n\nYou can create two kinds of customers on Google Workspace:\n\n- **Domain-verified customers** . These customers need Gmail and need full administrator access. When you create this type of customer, set the `customerType` to `domain`.\n- **Email-verified customers** . These customers don't own or manage their domain. When you create this type of customer, set the `customerType` to `team`. These type of customers can purchase the [Essentials and Enterprise Essentials](https://support.google.com/channelservices/answer/9398241?ref_topic=9755957) editions of Google Workspace.\n\nThe following JSON request body is an example of a domain-verified customer: \n\n```\n{\n \"customerDomain\": \"DOMAIN_NAME\",\n \"customerType\": \"domain\",\n \"postalAddress\": {\n \"contactName\": \"NAME\",\n \"organizationName\": \"ORGANIZATION_NAME\",\n \"postalCode\": \"POSTAL_CODE\",\n \"countryCode\": \"COUNTRY_CODE\"\n },\n \"alternateEmail\": \"EMAIL_ADDRESS\"\n}\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eDOMAIN_NAME\u003c/var\u003e: your customer's domain---for example, `example.com`\n- \u003cvar translate=\"no\"\u003eNAME\u003c/var\u003e: your customer's name---for example, `Alex Cruz`.\n- \u003cvar translate=\"no\"\u003eORGANIZATION_NAME\u003c/var\u003e: your customer's organization name---for example, `Example Organization`.\n- \u003cvar translate=\"no\"\u003ePOSTAL_CODE\u003c/var\u003e: your customer's ZIP or postal code---for example, `94043`.\n- \u003cvar translate=\"no\"\u003eCOUNTRY_CODE\u003c/var\u003e: your customer's 2 character [ISO country code](https://countrycode.org/).\n- \u003cvar translate=\"no\"\u003eEMAIL_ADDRESS\u003c/var\u003e: your customer's email address---for example, `cruz@example.com`.\n\nA successful response returns an HTTP `200` status code and the new customer's\ninformation: \n\n```\n{\n \"kind\": \"reseller#customer\",\n \"customerId\": \"CUSTOMER_ID\",\n \"customerDomain\": \"DOMAIN_NAME\",\n \"customerType\": \"domain\",\n \"postalAddress\": {\n \"kind\": \"customers#address\",\n \"contactName\": \"NAME\",\n \"organizationName\": \"ORGANIZATION_NAME\",\n \"postalCode\": \"POSTAL_CODE\",\n \"countryCode\": \"COUNTRY_CODE\",\n },\n \"alternateEmail\": \"EMAIL_ADDRESS\"\n}\n```\n\nThe following JSON request body is an example of an email-verified customer: \n\n```\n{\n \"customerDomain\": \"DOMAIN_NAME\",\n \"customerType\": \"team\",\n \"primaryAdmin\": {\n \"primaryEmail\": \"EMAIL_ADDRESS\"\n },\n \"postalAddress\": {\n \"contactName\": \"NAME\",\n \"organizationName\": \"ORGANIZATION_NAME\",\n \"postalCode\": \"POSTAL_CODE\",\n \"countryCode\": \"COUNTRY_CODE\"\n },\n \"alternateEmail\": \"EMAIL_ADDRESS\"\n}\n```\n\nA successful response returns an HTTP `200` status code and the new customer's\ninformation: \n\n```\n{\n \"kind\": \"reseller#customer\",\n \"customerId\": \"CUSTOMER_ID\",\n \"customerDomain\": \"DOMAIN_NAME,\n \"customerType\": \"team\",\n \"primaryAdmin\": {\n \"primaryEmail\": \"EMAIL_ADDRESS\"\n },\n \"postalAddress\": {\n \"kind\": \"customers#address\",\n \"contactName\": \"NAME\",\n \"organizationName\": \"ORGANIZATION_NAME\",\n \"postalCode\": \"POSTAL_CODE\",\n \"countryCode\": \"COUNTRY_CODE\",\n },\n \"alternateEmail\": \"EMAIL_ADDRESS\"\n}\n```\n\nChange a customer's default language\n------------------------------------\n\nA customer's default language is only applied to *new* users when they're\ncreated. Existing users retain their current language even after you\nupdate the default language. Therefore, you must set the customer default\nlanguage before you create any users.\n\nA newly created customer has a default language of English. To change the\ndefault language, use the\n[`PATCH`](/workspace/admin/directory/v1/reference/customers/patch)\nor\n[`UPDATE`](/workspace/admin/directory/v1/reference/customers/update)\ncalls from the Directory API\n[Customers](/workspace/admin/directory/v1/reference/customers)\nendpoint.\n\nUse the Directory API to update the default `language` value for a customer: \n\n```\nPATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID\n```\n\nInclude the following JSON request body: \n\n```\n{\n \"language\":\"LANGUAGE_CODE\"\n}\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eCUSTOMER_ID\u003c/var\u003e: a unique identifier for your customer---for example, `C0123456`\n- \u003cvar translate=\"no\"\u003eLANGUAGE_CODE\u003c/var\u003e: an accepted [language code](/workspace/admin/directory/v1/languages) ---for example, `es` for Spanish.\n\nA successful JSON response returns an HTTP `200` status code and the updated\ncustomer resource: \n\n```\n{\n \"alternateEmail\": \"EMAIL_ADDRESS\",\n \"customerCreationTime\": \"2022-12-12T23:04:10.620Z\",\n \"customerDomain\": \"DOMAIN_NAME\",\n \"id\": \"CUSTOMER_ID\",\n \"kind\": \"admin#directory#customer\",\n \"language\": \"LANGUAGE_CODE\",\n \"postalAddress\": {\n \"contactName\": \"NAME\",\n \"countryCode\": \"COUNTRY_CODE\",\n \"organizationName\": \"ORGANIZATION_NAME\",\n \"postalCode\": \"POSTAL_CODE\"\n }\n}\n```\n\nNext steps\n----------\n\n- [Reseller API common errors](/workspace/admin/reseller/v1/support/reseller_api_common_errors)\n- [Directory API common errors](/workspace/admin/reseller/v1/support/directory_api_common_errors)"]]
