Method: users.settings.cse.identities.create

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

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

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.

Anfragetext

Der Anfragetext enthält eine Instanz von CseIdentity.

Antworttext

Bei Erfolg 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 im Leitfaden zur Autorisierung.