Recuperar e atualizar as informações da conta de um cliente

Para recuperar e atualizar as informações de um cliente usando a API para revendedores, existem duas maneiras de procurá-lo:

• Identificador exclusivo do cliente, por exemplo, C0123456
• Nome de domínio do cliente, por exemplo, example.com

Recuperar informações da conta de um cliente

Para recuperar informações da conta de um cliente, use a seguinte solicitação GET e inclua o token de autorização:

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Substitua CUSTOMER_ID pelo identificador exclusivo ou nome de domínio do cliente.

Retornos de resposta

Ao recuperar informações da conta de um cliente, você pode receber uma das seguintes respostas:

• Retorna todas as configurações do cliente. O cliente é um de seus clientes atuais. Usando a API para revendedores, é possível gerenciar as configurações da conta e da assinatura do cliente.

• Retorna as informações mínimas da conta do cliente. Se a resposta retornar apenas customerId, customerDomain e customerType, o Google ou outro revendedor gerenciará o cliente. Não é possível criar outro cliente com e-mail verificado para ele. Para gerenciar esse cliente, siga estas etapas:

  1. Recupere todas as assinaturas transferíveis do cliente para entender se a assinatura pode ser transferida e o número mínimo de licenças por usuário para a transferência.
  2. Transfira a assinatura.

• Retorna Multiple teams exist on this domain. Esse domínio tem um ou vários clientes de equipe associados a ele. Para adicionar outra equipe a esse domínio, siga estas etapas:

  1. Fazer o pedido de uma conta de cliente.
  2. Para criar um cliente com domínio verificado para o domínio, peça que ele compre uma assinatura direta pelo Google e verifique o domínio, assuma as equipes atuais e, em seguida, transfira a assinatura para sua conta.

• Retorna um erro HTTP 404. O cliente é novo no Google e não tem uma conta. Para gerenciar o cliente, siga estas etapas:

  1. Confirme se os registros de clientes não mantêm dados de clientes antigos com uma possível incompatibilidade entre o nome de domínio principal de um cliente e o identificador de cliente exclusivo do Google. Quando uma Conta do Google excluída é restabelecida, ela é tratada como uma nova conta e tem um novo valor de customerId, mesmo que a conta mantenha o mesmo valor de customerDomain.
  2. Pedir uma nova conta de cliente.
  3. Crie uma assinatura para essa nova conta de cliente.

Atualizar as configurações de um cliente

Com a API Revendedor não é possível atualizar o customerType, mas você pode verificar o domínio de um cliente team e se tornar cliente domain.

Para atualizar as configurações de um cliente, use a seguinte solicitação PUT e inclua o identificador exclusivo do seu cliente:

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

O corpo da solicitação JSON atualiza as seguintes configurações do cliente:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "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 cliente, por exemplo, Example Organization.
• POSTAL_CODE: o CEP ou código postal do seu cliente. Por exemplo, 94043.
• COUNTRY_CODE: o código do país ISO de dois caracteres do seu cliente.
• EMAIL_ADDRESS: o endereço de e-mail do cliente. Por exemplo, [e-mail].

Uma resposta JSON bem-sucedida retorna um código de status HTTP 200 e as configurações de cliente atualizadas:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}