Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Antes de criar uma conta de cliente, considere o seguinte:
Pode haver restrições de código do país. Para confirmar se o país do cliente está aprovado para revenda, consulte o Partner Sales Console.
Se a conta foi criada ao fazer upgrade de uma conta pessoal do Gmail para um e-mail comercial com um nome de domínio, verifique se ela tem outras configurações do Google Workspace desbloqueadas. Para mais informações, consulte
Criar e-mails comerciais para a equipe
e
Criar um alias de e-mail comercial.
Criar uma conta de cliente
Para criar uma conta de cliente, use a seguinte solicitação POST e inclua o token de autorização:
POST https://reseller.googleapis.com/apps/reseller/v1/customers
Na conta do novo cliente, crie um usuário.
Se a resposta retornar um código de status HTTP 409 Conflict, o
customerId já vai existir. Antes de registrar a conta do cliente, você precisa transferir as assinaturas dele.
Promova o
usuário à função de superadministrador.
Ao criar a conta de administrador, você pode gerar uma senha temporária aleatória ou pedir que o cliente forneça uma senha.
Informe ao cliente que ele precisa fazer login no Admin Console e
assinar o contrato do Google Workspace via revendedor para ativar
a conta. Os revendedores não podem assinar os Termos de Serviço em nome do cliente.
Tipos de clientes
É possível criar dois tipos de clientes no Google Workspace:
Clientes com domínio verificado. Esses clientes precisam do Gmail e de acesso total de administrador. Ao criar esse tipo de cliente, defina customerType como domain.
Clientes com e-mail verificado. Esses clientes não são proprietários nem gerenciam o domínio deles. Ao criar esse tipo de cliente, defina customerType como team. Esses clientes podem comprar as edições Essentials e Enterprise Essentials do Google Workspace.
O corpo da solicitação JSON a seguir é um exemplo de um cliente com domínio verificado:
O idioma padrão de um cliente só é aplicado a novos usuários quando eles são criados. Os usuários atuais mantêm o idioma atual mesmo depois que você
atualiza o idioma padrão. Portanto, defina o idioma padrão do cliente antes de criar usuários.
Um cliente recém-criado tem o inglês como idioma padrão. Para mudar o idioma padrão, use as chamadas PATCH ou UPDATE do endpoint Customers da API Directory.
Use a API Directory para atualizar o valor padrão de language para um cliente:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)"]]
