Method: users.settings.delegates.create

添加委托人，并将其验证状态直接设置为 accepted，而不发送任何验证邮件。委托用户必须与受托用户属于同一 Google Workspace 组织。如需了解详情，请参阅管理委托人。

Gmail 对 Google Workspace 组织中的每位用户可以拥有的受托人和委托人数量施加了限制。这些限制因组织而异，但一般来说，每位用户最多可以有 25 位受托人和 10 位委托人。

委托用户必须使用其主邮箱（而非邮箱别名）进行引用。

创建新委托人后，可能需要等待最多一分钟，新委托人才可供使用。

此方法仅适用于已获全网域委派权限的服务账号客户端。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
userId

string

用户的电子邮件地址。特殊值“me”可用于表示经过身份验证的用户。

请求正文

请求正文包含一个 Delegate 实例。

响应正文

如果成功，响应正文将包含一个新创建的 Delegate 实例。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅授权指南。