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
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-05 (世界標準時間)。
[null,null,["上次更新時間:2024-09-05 (世界標準時間)。"],[[["Lists delegates for a specified account, accessible only to service accounts with domain-wide authority."],["Employs a `GET` request to the endpoint `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates`, using gRPC Transcoding syntax."],["Requires an empty request body and returns a JSON response containing a list of delegates, if any."],["Needs authorization with specific OAuth scopes like `https://www.googleapis.com/auth/gmail.settings.basic` or `https://www.googleapis.com/auth/gmail.modify`."]]],["A `GET` request is made to `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates` to list an account's delegates. The `userId` path parameter, which can be \"me,\" specifies the user. The request body must be empty. The response body, if successful, includes a JSON structure with a list of delegate objects under the \"delegates\" field. This action requires service account clients with domain-wide authority and specific OAuth scopes.\n"]]