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.

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/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 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 com os endereços de e-mail do delegador 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.