Pedir uma nova conta de cliente

Antes de criar uma nova conta de cliente, observe 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ê deve 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 ao cliente que forneça uma senha.

  5. Notifique o cliente de que ele precisa fazer login no Google Admin Console e assinar o contrato do Google Workspace para revendedores para ativar a conta. Os revendedores não podem assinar os Termos de Serviço em nome do cliente.

Tipos de clientes

Você pode criar dois tipos de clientes no Google Workspace:

  • Clientes com domínio verificado: esses clientes precisam do Gmail e acesso total de administrador. Ao criar esse tipo de cliente, defina customerType como domain.
  • Clientes com e-mail verificado: esses clientes não têm nem gerenciam o domínio. Ao criar esse tipo de cliente, defina customerType como team. Esses clientes podem comprar as edições do Google Workspace Essentials e do Google Workspace Enterprise Essentials.

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 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 ou código postal do cliente, por exemplo, 94043.
  • COUNTRY_CODE: o código do país ISO de duas letras 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 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ó se aplica a novos usuários. Os usuários atuais mantêm o idioma depois que você atualiza o idioma padrão. Portanto, defina o idioma padrão do cliente antes de criar usuários.

Um novo cliente tem o inglês como idioma padrão. Para mudar o idioma padrão, use os PATCH ou UPDATE métodos do endpoint Customers da API Directory.

Use a API Directory para atualizar o valor language padrão de 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:

Uma resposta JSON bem-sucedida retorna um código de status HTTP 200 e o recurso do 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