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.

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

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 speziellen Wert me verwenden, um den authentifizierten Nutzer anzugeben.

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.