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

Para extrair e atualizar as informações de um cliente usando a API Reseller, você tem duas opções:

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

Extrair 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 seu cliente.

Devoluções de resposta

Ao extrair 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. Usando a API Reseller, você pode 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 Google ou outro revendedor gerencia o cliente. Não é possível criar outro cliente verificado por e-mail 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. Transferir 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. Solicitar uma conta de cliente.
  2. Para criar um cliente com domínio verificado, peça para o cliente comprar uma assinatura direta pelo Google e verificar o domínio, assumir as equipes atuais e, em seguida, transferir 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 contêm dados antigos com uma possível incompatibilidade do nome de domínio principal de um cliente e do identificador de cliente exclusivo do Google. Quando uma Conta do Google excluída é restaurada, ela é tratada como uma nova conta e tem um novo valor de customerId, mesmo que possa manter o mesmo valor de customerDomain.
  2. Solicitar uma nova conta de cliente.
  3. Crie uma assinatura para essa nova conta de cliente.

Atualizar as configurações de um cliente

Usando 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 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, [e-mail].

Uma resposta JSON bem-sucedida retorna um código de status HTTP 200 e as configurações do 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"
}