Method: users.settings.cse.keypairs.obliterate

Exclui um par de chaves de criptografia do lado do cliente de forma permanente e imediata. Só é possível excluir permanentemente pares de chaves que foram desativados por mais de 30 dias. Para desativar um par de chaves, use o método keypairs.disable.

O Gmail não pode restaurar ou descriptografar mensagens criptografadas por uma chave apagada. Os usuários autenticados e os administradores do Google Workspace perdem o acesso para ler as mensagens criptografadas.

Para administradores que gerenciam identidades e pares de chaves para usuários na organização, as solicitações exigem autorização com uma conta de serviço que tenha autoridade de delegação em todo o domínio para representar usuários com o escopo https://www.googleapis.com/auth/gmail.settings.basic.

Para usuários que gerenciam as próprias identidades e pares de chaves, as solicitações exigem a criptografia de chaves de hardware ativada e configurada.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
userId

string

O endereço de e-mail principal do solicitante. Para indicar o usuário autenticado, use o valor especial me.
keyPairId

string

O identificador do par de chaves a ser destruído.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta será um objeto JSON vazio.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte o guia de autorização.