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

要清除的密钥对的标识符。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文为空的 JSON 对象。

授权范围

需要以下 OAuth 范围之一：

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

如需了解详情，请参阅授权指南。