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

詳情請參閱OAuth 2.0 Overview