Method: users.settings.cse.keypairs.obliterate

永久且立即刪除用戶端加密金鑰組。只有停用超過 30 天的金鑰組才能永久刪除。如要關閉金鑰組，請使用 keypairs.disable 方法。

如果郵件是使用已清除的金鑰加密，Gmail 就無法還原或解密。通過驗證的使用者和 Google Workspace 管理員將無法讀取加密訊息。

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

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

HTTP 要求

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate

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

路徑參數

參數
userId

string

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

string

要清除的金鑰組 ID。

要求主體

要求主體必須為空白。

回應主體

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

授權範圍

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

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

詳情請參閱OAuth 2.0 Overview。