API Directory: gerenciar clientes

Você pode usar a API Directory para gerenciar seus clientes de forma programática. Os métodos dessa API permitem atualizar os dados de contato no domínio do G Suite, bem como alterar o domínio principal da instância.

Recuperar um cliente

Para recuperar um cliente atual, use a seguinte solicitação HTTP GET e inclua o token de autorização descrito em Como autorizar solicitações. O customerKey pode ser o customerId exclusivo ou my_customer para indicar o cliente atual.

GET https://admin.googleapis.com/admin/directory/v1/customers/customerKey

Quando a resposta é bem-sucedida, um código de status HTTP 200 é retornado. Junto com o código de status, a resposta JSON inclui as informações do cliente:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "[e-mail]",
  "id": "C03xgje4y",
  "customerDomain": "amatchmadeinspace.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "countryCode": "US"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

Atualizar um cliente atual

Para atualizar um cliente atual, use a seguinte solicitação HTTP PUT e inclua o token de autorização descrito em Como autorizar solicitações. O customerKey pode ser o customerId exclusivo do cliente ou my_customer para indicar o cliente atual.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

Quando a resposta é bem-sucedida, um código de status HTTP 200 é retornado. Junto com o código de status, a resposta JSON inclui as informações do cliente recém-atualizadas:

{
  "alternateEmail": "[e-mail]",
  "customerDomain": "amatchmadeinspace.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "[phone]"
  }
}

Quando a resposta é bem-sucedida, um código de status HTTP 200 é retornado. Junto com o código de status, a resposta JSON inclui as informações do cliente:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "[e-mail]",
  "id": "C03xgje4y",
  "customerDomain": "amatchmadeinspace.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "[phone]"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

Como alterar o nome de domínio principal de um cliente

Observação :você precisa recuperar o valor customerId exclusivo do cliente usando a solicitação HTTP descrita em Recuperar um cliente. Esse valor vai permanecer consistente, mesmo depois que o nome de domínio principal for alterado.

Para alterar o domínio principal de um cliente, use a seguinte solicitação HTTP PUT e inclua o token de autorização descrito em Como autorizar solicitações. O customerKey precisa ser o customerId exclusivo ou my_customer.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

O corpo da solicitação JSON precisa incluir o novo valor customerDomain:

{
  "alternateEmail": "[e-mail]",
  "customerDomain": "fluxcapacitor.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "[phone]"
  }
}

Quando a resposta é bem-sucedida, um código de status HTTP 200 é retornado. Junto com o código de status, a resposta JSON inclui as informações do cliente:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "[e-mail]",
  "id": "C03xgje4y",
  "customerDomain": "fluxcapacitor.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "[phone]"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}