Method: users.settings.delegates.delete
Remove o delegado especificado (que pode ter qualquer status de verificação) e revoga qualquer verificação que tenha sido necessária para usá-lo.
O usuário delegado precisa ser identificado pelo endereço de e-mail principal, não por um alias.
Esse método está disponível apenas para clientes de contas de serviço que receberam autoridade delegada em todo o domínio.
Solicitação HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
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.
|
delegateEmail |
string
O endereço de e-mail do usuário que será removido como delegado.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta será um objeto JSON vazio.
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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-03-14 UTC.
[null,null,["Última atualização 2025-03-14 UTC."],[[["Removes a delegate user identified by their primary email address, revoking any associated verification."],["This action is restricted to service account clients with delegated domain-wide authority."],["The request must specify the user and delegate's email addresses as path parameters."],["A successful operation results in an empty response body, indicating the delegate was removed."],["This functionality requires the `https://www.googleapis.com/auth/gmail.settings.sharing` OAuth scope for authorization."]]],["This outlines how to remove a delegate from a user's Gmail account. A `DELETE` HTTP request is sent to a specific URL, including the user's email (`userId`) and the delegate's email (`delegateEmail`) as path parameters. The request body must be empty. A successful removal returns an empty response body. This operation is only available to service accounts with domain-wide authority, and it requires the `gmail.settings.sharing` authorization scope. Only primary email address can be used for the delegate.\n"]]
