Gerenciar delegados de contato

Este guia mostra como criar, listar e excluir delegados de contato para usuários do Google Workspace.

Os usuários do Google Workspace podem permitir que outras pessoas no domínio acessem e gerenciem os contatos delas. Esses delegados podem adicionar e atualizar contatos com informações como nomes, números de telefone e endereços.

Este guia é para delegar acesso aos contatos. Para delegar acesso ao Gmail, consulte Delegar e colaborar no e-mail.

Pré-requisitos

Antes de usar a API Contact Delegation, verifique se você atende aos seguintes requisitos:

  • Ativar o compartilhamento de contatos: um administrador do diretório precisa ativar o compartilhamento de contatos no Admin Console. Para mais informações, consulte Ativar ou desativar o compartilhamento de contatos.
  • Privilégios de administrador: você precisa ter o privilégio de administrador "Contatos" para gerenciar delegados de outros usuários.
  • Restrição de domínio: só é possível delegar contatos entre usuários da mesma organização do Google Workspace.
  • Escopo do OAuth: seu aplicativo precisa usar o seguinte escopo do OAuth: https://www.googleapis.com/auth/admin.contact.delegation.

Criar um delegado

Para criar um delegado para um usuário, envie uma solicitação POST com o endereço de e-mail do delegante:

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

Substitua USER_EMAIL pelo endereço de e-mail do delegador.

No corpo da solicitação, forneça o endereço de e-mail do delegado:

{
  "email": "DELEGATE_EMAIL"
}

Substitua DELEGATE_EMAIL pelo endereço de e-mail do delegado.

Uma resposta bem-sucedida retorna um código de status HTTP 200 e o e-mail do novo delegado:

{
  "email": "DELEGATE_EMAIL"
}

Listar delegados

Para listar delegados dos contatos de um usuário, envie uma solicitação GET com o endereço de e-mail dele:

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

Substitua USER_EMAIL pelo endereço de e-mail do usuário.

Uma resposta bem-sucedida retorna um código de status HTTP 200 e uma lista de e-mails de delegados:

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

Excluir um delegado

Para excluir um delegado dos contatos de um usuário, siga estas etapas:

  1. Identifique o delegado que você quer remover. Use o método List delegates para encontrar o endereço de e-mail de um delegado específico.

  2. Envie uma solicitação DELETE com os endereços de e-mail do delegador e do delegado:

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

Substitua USER_EMAIL pelo endereço de e-mail do delegador e DELEGATE_EMAIL pelo endereço de e-mail do delegado.

Uma resposta bem-sucedida retorna um código de status HTTP 200.