Method: users.settings.delegates.create

Adiciona um delegado com o status de verificação definido diretamente como accepted, sem enviar um e-mail de verificação. O usuário delegado precisa ser membro da mesma organização do Google Workspace que o usuário delegador. Para mais informações, consulte Gerenciar delegados.

O Gmail impõe limitações ao número de delegados e delegadores que cada usuário em uma organização do Google Workspace pode ter. Esses limites dependem da sua organização, mas, em geral, cada usuário pode ter até 25 delegados e até 10 delegadores.

Um usuário delegado precisa ser referenciado pelo endereço de e-mail principal, não por um alias de e-mail.

Quando um novo delegado é criado, pode haver um atraso de até um minuto antes que ele fique disponível para uso.

Esse método só está disponível para clientes de contas de serviço que receberam autoridade delegada em todo o domínio.

Solicitação HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
userId

string

Endereço de e-mail do usuário. O valor especial "me" pode ser usado para indicar o usuário autenticado.

Corpo da solicitação

O corpo da solicitação contém uma instância de Delegate.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Delegate.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/gmail.settings.sharing

Para mais informações, consulte o guia de autorização.