Method: users.settings.delegates.delete
移除指定的受托人(其验证状态可以是任何状态),并撤消使用该受托人可能需要完成的所有验证。
请注意,必须使用受托人用户的主电子邮件地址(而非电子邮件别名)来引用该用户。
此方法仅适用于已委派全网域权限的服务账号客户端。
HTTP 请求
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
网址采用 gRPC 转码语法。
路径参数
参数 |
userId |
string
用户的电子邮件地址。特殊值“me”可用于指明经过身份验证的用户。
|
delegateEmail |
string
要移除其委托人身份的用户的电子邮件地址。
|
响应正文
如果成功,则响应正文为空的 JSON 对象。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/gmail.settings.sharing
如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-03-14。
[null,null,["最后更新时间 (UTC):2025-03-14。"],[[["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"]]