Gestisci delegati contatti

Questa guida spiega come creare, elencare ed eliminare i delegati dei contatti per gli utenti di Google Workspace.

Gli utenti di Google Workspace possono concedere ad altri utenti del proprio dominio l'autorizzazione ad accedere ai propri contatti e gestirli. Questi delegati possono aggiungere e aggiornare contatti con informazioni come nomi, numeri di telefono e indirizzi.

Questa guida riguarda la delega dell'accesso ai contatti. Per delegare l'accesso a Gmail, vedi Delegare e collaborare con l'email.

Prerequisiti

Prima di utilizzare l'API Contact Delegation, assicurati di soddisfare i seguenti requisiti:

  • Attiva la condivisione dei contatti: un amministratore della directory deve attivare la condivisione dei contatti nella Console di amministrazione. Per ulteriori informazioni, vedi Attivare o disattivare la condivisione dei contatti.
  • Privilegi di amministratore: per gestire i delegati per altri utenti, devi disporre del privilegio di amministratore "Contatti".
  • Limitazione del dominio: puoi delegare i contatti solo tra utenti della stessa organizzazione Google Workspace.
  • Ambito OAuth: la tua applicazione deve utilizzare il seguente ambito OAuth: https://www.googleapis.com/auth/admin.contact.delegation.

Creare un delegato

Per creare un delegato per un utente, invia una richiesta POST con l'indirizzo email del delegante:

POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

Sostituisci USER_EMAIL con l'indirizzo email del delegante.

Nel corpo della richiesta, fornisci l'indirizzo email del delegato:

{
  "email": "DELEGATE_EMAIL"
}

Sostituisci DELEGATE_EMAIL con l'indirizzo email del delegato.

Una risposta riuscita restituisce un codice di stato HTTP 200 e l'email del nuovo delegato:

{
  "email": "DELEGATE_EMAIL"
}

Elenca delegati

Per elencare i delegati per i contatti di un utente, invia una richiesta GET con l'indirizzo email dell'utente:

GET https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

Sostituisci USER_EMAIL con l'indirizzo email dell'utente.

Una risposta riuscita restituisce un codice di stato HTTP 200 e un elenco di indirizzi email delegati:

{
  "delegates": [
    {
      "email": "DELEGATE_EMAIL_1"
    },
    {
      "email": "DELEGATE_EMAIL_2"
    }
  ]
}

Eliminare un delegato

Per eliminare un delegato per i contatti di un utente:

  1. Identifica il delegato da rimuovere. Utilizza il metodo List delegates per trovare l'indirizzo email di un delegato specifico.

  2. Invia una richiesta DELETE con gli indirizzi email del delegante e del delegato:

    DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL

Sostituisci USER_EMAIL con l'indirizzo email del delegante e DELEGATE_EMAIL con l'indirizzo email del delegato.

Una risposta riuscita restituisce un codice di stato HTTP 200.