Peça uma nova conta de cliente

Antes de criar uma nova conta de cliente, considere o seguinte:

Criar uma conta de cliente

  1. 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

  2. Na conta do novo cliente, crie um usuário. Se a resposta retornar um código de status HTTP 409 Conflict, o customerId já existe. Antes de registrar a conta do cliente, você precisa transferir as assinaturas do cliente.

  3. Se aplicável, altere o idioma padrão do cliente.

  4. Promova o usuário à função de superadministrador. Ao criar a conta de administrador, é possível gerar uma senha aleatória temporária ou solicitar que o cliente forneça uma senha.

  5. Informe ao cliente que ele precisa fazer login no Admin Console e assinar o Google Workspace via Contrato de revendedor para ativar a conta. Os revendedores estão proibidos de assinar os Termos de Serviço em nome do cliente.

Tipos de clientes

Você pode criar dois tipos de cliente 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. 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 cliente com domínio verificado:

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

Substitua:

  • DOMAIN_NAME: o domínio do seu cliente, por exemplo, example.com
  • NAME: o nome do cliente, por exemplo, Alex Cruz.
  • ORGANIZATION_NAME: o nome da organização do seu cliente, por exemplo, Example Organization.
  • POSTAL_CODE: o CEP ou código postal do seu cliente. Por exemplo, 94043.
  • COUNTRY_CODE: o código ISO do país de dois caracteres do seu cliente.
  • EMAIL_ADDRESS: o endereço de e-mail do cliente. Por exemplo, cruz@example.com.

Uma resposta bem-sucedida retorna um código de status HTTP 200 e as informações do novo cliente:

{
  "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"
}

O corpo da solicitação JSON a seguir é um exemplo de cliente com e-mail verificado:

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

Uma resposta bem-sucedida retorna um código de status HTTP 200 e as informações do novo cliente:

{
  "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"
}

Alterar o idioma padrão de um cliente

O idioma padrão de um cliente só é aplicado a novos usuários quando eles são criados. Os usuários existentes vão manter o idioma atual mesmo depois que o padrão é atualizado. Portanto, defina o idioma padrão do cliente antes de criar usuários.

Um cliente recém-criado tem um idioma padrão de inglês. Para alterar o idioma padrão, use as chamadas PATCH ou UPDATE do endpoint Clientes da API Directory.

Use a API Directory para atualizar o valor padrão do language para um cliente:

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

Inclua o corpo da solicitação JSON a seguir:

{
  "language":"LANGUAGE_CODE"
}

Substitua:

  • CUSTOMER_ID: um identificador exclusivo do cliente, por exemplo, C0123456.
  • LANGUAGE_CODE: um código de idioma aceito, por exemplo, es para espanhol.

Uma resposta JSON bem-sucedida retorna um código de status HTTP 200 e o recurso de cliente atualizado:

{
  "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"
  }
}

Próximas etapas