Löscht eine Identität für die clientseitige Verschlüsselung. Der authentifizierte Nutzer kann die Identität nicht mehr verwenden, um verschlüsselte Nachrichten zu senden.
Sie können die Identität nach dem Löschen nicht wiederherstellen. Verwenden Sie stattdessen die Methode identities.create, um eine weitere Identität mit derselben Konfiguration zu erstellen.
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
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
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 |
cseEmailAddress |
Die primäre E‑Mail-Adresse, die mit der entfernten Identitätskonfiguration für die clientseitige Verschlüsselung verknüpft ist. |
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.