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

Para recuperar e atualizar as informações de um cliente usando a API Reseller, você tem duas maneiras de pesquisar o cliente:

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

Recuperar as informações da conta de um cliente

Para recuperar as 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 as informações da conta de um cliente, você pode receber uma das seguintes respostas:

• Retorna todas as configurações do cliente. O cliente é um dos seus clientes atuais. Com a API Reseller, é possível gerenciar as configurações da conta e da assinatura desse cliente.

• Retorna as informações mínimas da conta do cliente. Se a resposta retornar apenas customerId, customerDomain e customerType, o cliente será gerenciado pelo Google ou por outro revendedor. Não é possível criar outro cliente com e-mail verificado para o cliente. 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 de 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. Pedir uma conta de cliente.
  2. Para criar um cliente com domínio verificado, peça que ele compre uma assinatura direta pelo Google e verifique o domínio, assuma o controle das equipes atuais e depois transfira a assinatura para sua conta.

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

  1. Confirme se os registros de clientes não têm dados antigos com uma possível incompatibilidade entre o nome de domínio principal de um cliente e o identificador exclusivo do cliente do Google. Quando uma Conta do Google excluída anteriormente é 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 Reseller, não é possível atualizar o customerType, mas é possível verificar o domínio de um cliente team e se tornar um cliente domain.

Para atualizar as configurações de um cliente, use a seguinte solicitação PUT e inclua o identificador exclusivo do 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 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, [e-mail].

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

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