Gerenciar delegados de contato

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

Se você usa o Google Workspace, pode permitir que outros usuários do seu domínio acessem e gerenciem seus contatos. Esses delegados podem adicionar e atualizar contatos com informações como nomes, números de telefone e endereços.

Criar um delegado

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

POST https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates

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

{
  "email": "delegate@example.com"
}

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

{
  "email": "delegate@example.com"
}

Listar delegados

Para listar os 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/delegator@example.com/delegates

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

{
  "delegates": [
    {
      "email": "delegate1@example.com"
    },
    {
      "email": "delegate2@example.com"
    }
  ]
}

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 que contenha o endereço de e-mail do delegante e do delegado:

    DELETE https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates/delegate@example.com

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