Löscht ein Schlüsselpaar für die clientseitige Verschlüsselung dauerhaft und sofort. Sie können nur Schlüsselpaare endgültig löschen, die seit mehr als 30 Tagen deaktiviert sind. Verwenden Sie die Methode keypairs.disable, um ein Schlüsselpaar zu deaktivieren.
Gmail kann keine Nachrichten wiederherstellen oder entschlüsseln, die mit einem gelöschten Schlüssel verschlüsselt wurden. Authentifizierte Nutzer und Google Workspace-Administratoren verlieren den Zugriff auf das Lesen der verschlüsselten Nachrichten.
Administratoren, die Identitäten und Schlüsselpaare für Nutzer in ihrer Organisation verwalten, müssen Anfragen mit einem Dienstkonto autorisieren, das domainweite Delegierungsberechtigungen hat, um Nutzer mit dem Bereich https://www.googleapis.com/auth/gmail.settings.basic zu imitieren.
Für Nutzer, die ihre eigenen Identitäten und Schlüsselpaare verwalten, muss die Hardware-Schlüsselverschlüsselung aktiviert und konfiguriert sein.
HTTP-Anfrage
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter | |
|---|---|
userId |
Die primäre E-Mail-Adresse des Antragstellers. Um den authentifizierten Nutzer anzugeben, können Sie den speziellen Wert |
keyPairId |
Die Kennung des zu löschenden Schlüsselpaars. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/gmail.settings.basichttps://www.googleapis.com/auth/gmail.settings.sharing
Weitere Informationen finden Sie unter OAuth 2.0 Overview.