Puoi utilizzare l'API Directory per gestire i tuoi clienti in modo programmatico. I metodi di questa API ti consentono di aggiornare i dati di contatto del tuo dominio G Suite, nonché di modificare il dominio principale dell'istanza.
Recuperare un cliente
Per recuperare un cliente esistente, utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione descritto nell'articolo relativo alle richieste di autorizzazione. customerKey può essere l'ID cliente univoco o my_customer per indicare il cliente corrente.
GET https://admin.googleapis.com/admin/directory/v1/customers/customerKey
Una risposta riuscita restituisce un codice di stato HTTP 200. Oltre al codice di stato, la risposta JSON include le informazioni del 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"
}
Aggiornare un cliente esistente
Per aggiornare un cliente esistente, utilizza la seguente richiesta HTTP PUT e includi il token di autorizzazione descritto nell'articolo relativo all'autorizzazione delle richieste. customerKey può essere il customerId univoco del cliente o my_customer per indicare il cliente corrente.
PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey
Una risposta riuscita restituisce un codice di stato HTTP 200. Oltre al codice di stato, la risposta JSON include le informazioni del cliente appena aggiornate:
{
"alternateEmail": "marty.mcfly@gmail.com",
"customerDomain": "amatchmadeinspace.com",
"language": "EN",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
}
}
Una risposta riuscita restituisce un codice di stato HTTP 200. Oltre al codice di stato, la risposta JSON include le informazioni del 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"
}
Modificare il nome di dominio principale di un cliente
Per modificare il dominio principale di un cliente, utilizza la seguente richiesta HTTP PUT e includi il token di autorizzazione descritto nell'articolo relativo all'autorizzazione delle richieste.
customerKey deve essere il customerId univoco o my_customer.
PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey
Il corpo della richiesta JSON deve includere il nuovo valore customerDomain:
{
"alternateEmail": "marty.mcfly@gmail.com",
"customerDomain": "fluxcapacitor.com",
"language": "EN",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
}
}
Una risposta riuscita restituisce un codice di stato HTTP 200. Oltre al codice di stato, la risposta JSON include le informazioni del 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"
}