Deaktiviert ein Schlüsselpaar für die clientseitige Verschlüsselung. Der authentifizierte Nutzer kann das Schlüsselpaar nicht mehr verwenden, um eingehende CSE-Nachrichten zu entschlüsseln oder ausgehende CSE-E-Mails zu signieren.
Wenn Sie wieder Zugriff erhalten möchten, aktivieren Sie das Schlüsselpaar mit der Taste keypairs.enable.
Nach 30 Tagen können Sie das Schlüsselpaar mit der Methode keypairs.obliterate endgültig löschen.
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/keypairs/{keyPairId}:disable
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 |
keyPairId |
Die Kennung des Schlüsselpaars, das deaktiviert werden soll. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von CseKeyPair.
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.