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

詳情請參閱授權指南