Method: users.settings.cse.identities.patch

Associe une autre paire de clés à une identité de chiffrement côté client existante. La paire de clés mise à jour doit être validée par les profils de certificat S/MIME de Google.

Pour les administrateurs qui gèrent les identités et les paires de clés des utilisateurs de leur organisation, les demandes nécessitent une autorisation avec un compte de service disposant d'une autorité de délégation au niveau du domaine pour usurper l'identité des utilisateurs avec le champ d'application https://www.googleapis.com/auth/gmail.settings.basic.

Pour les utilisateurs qui gèrent leurs propres identités et paires de clés, les demandes nécessitent que le chiffrement par clé matérielle soit activé et configuré.

Requête HTTP

PATCH https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
userId

string

Adresse e-mail principale de la personne à l'origine de la demande. Pour indiquer l'utilisateur authentifié, vous pouvez utiliser la valeur spéciale me.

emailAddress

string

Adresse e-mail de l'identité de chiffrement côté client à mettre à jour.

Corps de la requête

Le corps de la requête contient une instance de CseIdentity.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de CseIdentity.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://www.googleapis.com/auth/gmail.settings.sharing

Pour en savoir plus, consultez le guide d'autorisation.