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

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