Method: users.settings.cse.identities.delete

刪除用戶端加密身分。已通過驗證的使用者無法再使用該身分傳送加密訊息。

刪除身分識別碼後,就無法還原。請改用 identities.create 方法,以相同的設定建立其他身分。

管理員負責管理機構內使用者的身分和金鑰組,因此要求必須透過服務帳戶授權,該帳戶具備全網域委派權限,可模擬具有 https://www.googleapis.com/auth/gmail.settings.basic 範圍的使用者。

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

HTTP 要求

DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}

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

路徑參數

參數
userId

string

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

cseEmailAddress

string

與已移除的用戶端加密身分設定相關聯的主要電子郵件地址。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會是空白的 JSON 物件。

授權範圍

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

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

詳情請參閱授權指南