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, é possível pesquisar um cliente de duas maneiras:

• 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 as configurações completas 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 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 com e-mail verificado para eles. Para gerenciar esse cliente, siga estas etapas:

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

• Retorna Multiple teams exist on this domain: este domínio tem um ou mais 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 para ele comprar uma assinatura direta e verificar o domínio, depois transfira a assinatura.

• 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 seus registros não têm dados antigos de clientes com uma incompatibilidade entre o nome de domínio principal e o identificador exclusivo do cliente do Google. Quando uma conta excluída é restabelecida, ela é tratada como uma nova conta com um novo customerId.
  2. Pedir uma nova conta de cliente.
  3. Crie uma assinatura para a 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 para 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 ou código postal 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"
}