Method: users.settings.delegates.create
將驗證狀態直接設為 accepted 的委派代表，不必傳送任何驗證電子郵件。委派使用者必須是與委派使用者相同 Google Workspace 機構的成員。
Gmail 對 Google Workspace 機構中每位使用者可擁有的委派人數和委派者數量設有限制。這些限制取決於貴機構，但一般而言，每位使用者最多可有 25 個委派代表和 10 位委派者。
請注意，委派使用者必須透過主要電子郵件地址參照，而非電子郵件別名。
另請注意，建立新的委派項目後，最多可能要等待 1 分鐘，新的委派項目才能使用。
這個方法僅適用於已委派全網域授權的服務帳戶用戶端。
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
詳情請參閱授權指南。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2024-09-05 (世界標準時間)。
[null,null,["上次更新時間：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."]]],[]]
