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

有关详情,请参阅授权指南