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

詳情請參閱授權指南