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": "marty.mcfly@gmail.com",
"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": "marty.mcfly@gmail.com",
"customerDomain": "amatchmadeinspace.com",
"language": "EN",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
}
}
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": "marty.mcfly@gmail.com",
"id": "C03xgje4y",
"customerDomain": "amatchmadeinspace.com",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
},
"customerCreationTime": "2015-10-21T20:42:35.224Z"
}
Como alterar o nome de domínio principal de um cliente
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": "marty.mcfly@gmail.com",
"customerDomain": "fluxcapacitor.com",
"language": "EN",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
}
}
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": "marty.mcfly@gmail.com",
"id": "C03xgje4y",
"customerDomain": "fluxcapacitor.com",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
},
"customerCreationTime": "2015-10-21T20:42:35.224Z"
}