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
有关详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-05。
[null,null,["最后更新时间 (UTC):2024-09-05。"],[[["Adds a delegate to a user's Gmail account with verification status set to `accepted` without requiring email verification, given the delegate is in the same Google Workspace organization."],["Gmail has limits on the number of delegates and delegators a user can have, typically around 25 delegates and 10 delegators per user."],["Delegate users must be referred to by their primary email address, the new delegate may take up to a minute to be available, and this method requires domain-wide authority delegated to service account clients."],["This functionality is accessed via a POST request to the specified URL with path parameters including the user's email address, a request body containing a `Delegate` instance, and a response body, upon success, also containing a `Delegate` instance."],["Authorization for this method requires the `https://www.googleapis.com/auth/gmail.settings.sharing` OAuth scope."]]],[]]