Method: users.settings.cse.identities.delete
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.
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 |
string
Die primäre E-Mail-Adresse des Antragstellers. Sie können den authentifizierten Nutzer mit dem Sonderwert me angeben.
|
cseEmailAddress |
string
Die primäre E-Mail-Adresse, die mit der entfernten Konfiguration der clientseitigen Verschlüsselungsidentität 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.basic
https://www.googleapis.com/auth/gmail.settings.sharing
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-03-14 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-03-14 (UTC)."],[[["Permanently deletes a client-side encryption identity, preventing the authenticated user from sending encrypted messages with it."],["Requires providing the user's primary email address and the email address associated with the identity to be deleted in the request URL."],["The request body should be empty, and a successful deletion results in an empty response body."],["Proper authorization with specific OAuth scopes (`gmail.settings.basic` or `gmail.settings.sharing`) is necessary to perform this action."],["Once deleted, the identity cannot be restored; a new one with the same configuration must be created if needed."]]],["This document outlines how to delete a client-side encryption identity in Gmail. A `DELETE` HTTP request is sent to a specific URL, using `userId` (or \"me\") and `cseEmailAddress` as path parameters. The request body must be empty. A successful deletion results in an empty response body. Deleting an identity is permanent, requiring the creation of a new one. The action needs one of two specified OAuth scopes for authorization.\n"]]
