API Directory: Gestisci clienti

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 Google Workspace, nonché di modificare il dominio principale della tua istanza.

Recuperare un cliente

Per recuperare un cliente esistente, utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione descritto in Autorizzare le richieste. customerKey può essere customerId univoco o my_customer per indicare il cliente attuale.

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": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "countryCode": "US"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

Aggiornare un cliente esistente

Per aggiornare un cliente esistente, utilizza la seguente richiesta PUT e includi il token di autorizzazione descritto in Autorizzare le richieste. customerKey può essere l'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 sul cliente appena aggiornate:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "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 PUT e includi il token di autorizzazione descritto in Autorizzare le richieste. customerKey deve essere l'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": "yuri@example.com",
  "customerDomain": "example.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "Example.com",
    "phoneNumber": "+15558675309"
  }
}