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 sul tuo dominio Google Workspace, nonché di modificare il dominio principale per la tua 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 il customerId 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"
}