Method: users.settings.cse.identities.patch

將其他金鑰配對與現有的用戶端加密身分建立關聯。更新後的金鑰組必須通過 Google 的 S/MIME 憑證設定檔驗證。

如果管理員要為機構中的使用者管理身分和金鑰組,則必須使用服務帳戶授權要求,該帳戶必須具備全網域委派授權,才能以 https://www.googleapis.com/auth/gmail.settings.basic 範圍模擬使用者。

如果使用者自行管理身分和金鑰組,則必須開啟並設定硬體金鑰加密功能,才能提出要求。

HTTP 要求

PATCH https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
userId

string

要求者的主要電子郵件地址。如要指出已驗證的使用者,可以使用特殊值 me

emailAddress

string

要更新的用戶端加密身分電子郵件地址。

要求主體

要求主體包含 CseIdentity 的例項。

回應主體

如果成功,回應主體會包含 CseIdentity 的執行個體。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://www.googleapis.com/auth/gmail.settings.sharing

詳情請參閱OAuth 2.0 Overview