Method: users.settings.delegates.list

列出指定账号的受托人。

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

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
userId

string

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

请求正文

请求正文必须为空。

响应正文

对 delegates.list 方法的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "delegates": [
    {
      object (Delegate)
    }
  ]
}
字段
delegates[]

object (Delegate)

用户的受托人列表（包括任何验证状态）。如果账号没有受托人，系统将不会显示此字段。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly

有关详情，请参阅授权指南。