Löscht ein clientseitiges Verschlüsselungsschlüsselpaar endgültig 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.
In Gmail können keine Nachrichten wiederhergestellt oder entschlüsselt werden, die mit einem gelöschten Schlüssel verschlüsselt wurden. Authentifizierte Nutzer und Google Workspace-Administratoren verlieren den Zugriff auf die verschlüsselten Nachrichten.
Für Administratoren, die Identitäten und Schlüsselpaare für Nutzer in ihrer Organisation verwalten, ist für Anfragen eine Autorisierung mit einem Dienstkonto erforderlich, das domainweite Bevollmächtigung zur Identitätsübernahme von Nutzern mit dem Umfang https://www.googleapis.com/auth/gmail.settings.basic hat.
Für Nutzer, die ihre eigenen Identitäten und Schlüsselpaare verwalten, muss die Hardwareschlü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. Sie können 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 im Leitfaden zur Autorisierung.