Method: users.settings.cse.identities.patch

• HTTP リクエスト
• パスパラメータ
• リクエストの本文
• レスポンスの本文
• 認可スコープ
• 試してみる

既存のクライアントサイド暗号化 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

詳細については、OAuth 2.0 Overview をご覧ください。