Method: users.settings.cse.identities.patch

別の鍵ペアを既存のクライアントサイド暗号化 ID に関連付けます。更新された鍵ペアは、Google の S/MIME 証明書プロファイルと照合する必要があります。

組織内のユーザーの ID と鍵ペアを管理する管理者の場合、リクエストには、https://www.googleapis.com/auth/gmail.settings.basic スコープでユーザーの権限借用を行うためのドメイン全体の委任権限を持つサービス アカウントによる承認が必要です。

独自の ID と鍵ペアを管理しているユーザーの場合、リクエストでハードウェア キー暗号化を有効にして構成する必要があります。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
userId

string

リクエスト送信者のメインのメールアドレス。認証済みユーザーを示すには、特別な値 me を使用できます。

emailAddress

string

更新するクライアントサイド暗号化 ID のメールアドレス。

リクエストの本文

リクエストの本文には CseIdentity のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には CseIdentity のインスタンスが含まれます。

認可スコープ

以下のいずれかの OAuth スコープが必要です。

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

詳しくは、認可ガイドをご覧ください。