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

詳情請參閱授權指南