Hiermit wird einer vorhandenen Identität für die clientseitige Verschlüsselung ein anderes Schlüsselpaar zugewiesen. Das aktualisierte Schlüsselpaar muss anhand der S/MIME-Zertifikatprofile von Google validiert werden.
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
PATCH https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter | |
|---|---|
userId |
Die primäre E-Mail-Adresse des Antragstellers. Sie können den speziellen Wert |
emailAddress |
Die E-Mail-Adresse der Identität für die clientseitige Verschlüsselung, die aktualisiert werden soll. |
Anfragetext
Der Anfragetext enthält eine Instanz von CseIdentity.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von CseIdentity.
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 im Leitfaden zur Autorisierung.