Method: users.settings.cse.identities.create

Erstellt und konfiguriert eine Identität für die clientseitige Verschlüsselung, die berechtigt ist, E‑Mails über das Nutzerkonto zu senden. Google veröffentlicht das S/MIME-Zertifikat in einem gemeinsamen domainweiten Verzeichnis, damit Personen innerhalb einer Google Workspace-Organisation E-Mails an die Identität verschlüsseln und senden können.

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/identities

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
userId

string

Die primäre E-Mail-Adresse des Antragstellers. Um den authentifizierten Nutzer anzugeben, können Sie den speziellen Wert me verwenden.

Anfragetext

Der Anfragetext enthält eine Instanz von CseIdentity.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine neu erstellte Instanz von CseIdentity.

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 unter OAuth 2.0 Overview.