Pedir uma nova conta de cliente

Antes de criar uma 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á vai existir. Antes de registrar a conta do cliente, você precisa transferir as assinaturas dele.

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

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

  5. 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:

{
  "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 cliente, por exemplo, example.com
  • NAME: o nome do cliente, por exemplo, Alex Cruz.
  • ORGANIZATION_NAME: o nome da organização do cliente. Por exemplo, Example Organization.
  • POSTAL_CODE: o CEP do cliente. Por exemplo, 94043.
  • COUNTRY_CODE: o código ISO do país de dois caracteres do 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 um 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"
}

Mudar 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 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:

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

Inclua o seguinte corpo da solicitação JSON:

{
  "language":"LANGUAGE_CODE"
}

Substitua:

  • CUSTOMER_ID: um identificador exclusivo para seu 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