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

如需了解详情,请参阅 OAuth 2.0 Overview