Pedir 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, mude a linguagem padrão do cliente.

  4. Promova o usuário para a 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. Notifique o cliente de que ele precisa fazer login no Admin Console e assinar o contrato de revendedor do Google Workspace 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 de administrador completo. Ao criar esse tipo de cliente, defina o 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 o customerType como team. Esse tipo de cliente pode comprar as edições Essentials e Enterprise Essentials do Google Workspace.

O corpo da solicitação JSON a seguir é um exemplo de cliente verificado por domínio:

{
  "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 seu cliente, por exemplo, Example Organization.
  • POSTAL_CODE: o CEP ou código postal do cliente, por exemplo, 94043.
  • COUNTRY_CODE: o código de país ISO 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 verificação por e-mail:

{
  "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, é necessário definir 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 de 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 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