API Directory: Gestisci clienti

Puoi utilizzare l'API Directory per gestire i tuoi clienti in modo programmatico. I metodi utilizzati in questa API ti consentono di aggiornare le informazioni di contatto sul tuo dominio G Suite e di modificare il dominio principale per la tua istanza.

Recupera un cliente

Per recuperare un cliente esistente, utilizza la seguente richiesta HTTP GET e includi il token di autorizzazione descritto in Autorizzazione delle richieste. 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 corretta restituisce un codice di stato HTTP 200. Insieme 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"
}

Aggiorna un cliente esistente

Per aggiornare un cliente esistente, utilizza la seguente richiesta HTTP PUT e includi il token di autorizzazione descritto nella sezione Autorizzazione delle richieste. customerKey può essere l'ID cliente univoco del cliente oppure my_customer per indicare il cliente corrente.

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

Una risposta corretta restituisce un codice di stato HTTP 200. Insieme 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 corretta restituisce un codice di stato HTTP 200. Insieme 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"
}

Modifica del nome di dominio principale di un cliente

Per modificare il dominio principale di un cliente, usa la seguente richiesta HTTP PUT e includi il token di autorizzazione descritto in Autorizzazione delle richieste. customerKey deve essere l'ID cliente 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 corretta restituisce un codice di stato HTTP 200. Insieme 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"
}