Sign in with Google HTML API リファレンス

このリファレンス ページでは、ウェブページに [Google でログイン] ボタンまたはワンタップ プロンプトを表示するために使用される、Google でログインの HTML データ属性 API について説明します。

ID が「g_id_onload」の要素

「Google でログイン」のデータ属性は、<div> や <span> など、表示される要素または表示されない要素に配置できます。唯一の要件は、要素 ID が g_id_onload に設定されていることです。この ID を複数の要素に設定しないでください。

データ属性

次の表に、データ属性とその説明を示します。

属性
data-client_id アプリケーションのクライアント ID
data-color_scheme ワンタップ プロンプトに適用されるカラーパターン。
data-auto_prompt Google ワンタップを表示します。
data-auto_select Google One Tap での自動選択を有効にします。
data-login_uri ログイン エンドポイントの URL
data-callback JavaScript ID トークン ハンドラ関数名
data-native_login_uri パスワード認証情報ハンドラ エンドポイントの URL
data-native_callback JavaScript パスワード認証情報ハンドラ関数名
data-native_id_param credential.id 値のパラメータ名
data-native_password_param credential.password 値のパラメータ名
data-cancel_on_tap_outside ユーザーがプロンプトの外側をクリックした場合にプロンプトをキャンセルするかどうかを制御します。
data-prompt_parent_id ワンタップ プロンプトのコンテナ要素の DOM ID
data-skip_prompt_cookie 指定された Cookie に空でない値がある場合、ワンタップをスキップします。
data-nonce ID トークンのランダムな文字列
data-essential_claims Google から返される ID トークンに含める追加のクレーム。
data-context ワンタップ プロンプトのタイトルと文言
data-moment_callback プロンプト UI ステータス通知リスナーの関数名
data-state_cookie_domain 親ドメインとそのサブドメインでワンタップを呼び出す必要がある場合は、この属性に親ドメインを渡して、単一の共有 Cookie が使用されるようにします。
data-ux_mode [Google でログイン] ボタンの UX フロー
data-allowed_parent_origin 中間 iframe の埋め込みを許可されているオリジン。この属性が存在する場合、ワンタップは中間 iframe モードで実行されます。
data-intermediate_iframe_close_callback ユーザーがワンタップを手動で閉じたときのデフォルトの中間 iframe の動作をオーバーライドします。
data-itp_support ITP ブラウザでアップグレードされたワンタップ UX を有効にします。
data-login_hint ユーザーヒントを指定して、アカウントの選択をスキップします。
data-hd ドメインごとにアカウントの選択を制限します。
data-use_fedcm_for_prompt ブラウザがユーザーのログイン メッセージを制御し、ウェブサイトと Google の間のログインフローを仲介できるようにします。
data-use_fedcm_for_button このフィールドは、Chrome(デスクトップ M125 以降、Android M128 以降)で FedCM ボタン UX を使用するかどうかを決定します。デフォルトは false です。
data-button_auto_select FedCM ボタンフローで自動選択オプションを有効にするかどうか。有効にすると、アクティブな Google セッションを持つリピーターは、Account Chooser のプロンプトをバイパスして自動的にログインします。デフォルト値は false です。

属性タイプ

以降のセクションでは、各属性タイプについて詳しく説明し、例を示します。

data-client_id

この属性はアプリのクライアント ID です。これは Google Cloud コンソールで作成され、確認できます。詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 はい data-client_id="CLIENT_ID.apps.googleusercontent.com"

data-color_scheme

このフィールドは、ワンタップ プロンプトに適用されるカラーパターンです。詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可。デフォルトは、ユーザーのシステムのデフォルトのカラーパターンです。 data-color_scheme="dark"

次の表に、使用可能なカラーパターンとその説明を示します。

カラーパターン
default ユーザーのシステムにデフォルトのカラーパターンを適用します。ユーザーの設定パターンに応じて、ライトまたはダークになります。
light ライト カラーパターンを適用します。
dark ダークカラー パターンを適用します。

data-auto_prompt

この属性は、ワンタップを表示するかどうかを決定します。デフォルト値は true です。この値が false の場合、Google ワンタップは表示されません。詳細については、次の表をご覧ください。

タイプ 必須 例
ブール値 省略可 data-auto_prompt="true"

data-auto_select

この属性は、1 つの Google セッションのみがアプリを承認している場合に、ユーザーの操作なしで ID トークンを自動的に返すかどうかを決定します。デフォルト値は false です。詳しくは、次の表をご覧ください。

タイプ 必須 例
ブール値 省略可 data-auto_select="true"

data-login_uri

この属性は、ログイン エンドポイントの URI です。

この値は、Google Auth Platform で構成した OAuth 2.0 クライアントの承認済みリダイレクト URI のいずれかと完全に一致する必要があります。また、リダイレクト URI の検証ルールに準拠している必要があります。

現在のページがログインページである場合、この属性は省略できます。その場合、認証情報はデフォルトでこのページに送信されます。

コールバック関数が定義されておらず、ユーザーが [Google でログイン] ボタンまたは [ワンタップ] ボタンをクリックするか、自動ログインが行われると、ID トークン認証情報のレスポンスがログイン エンドポイントに送信されます。

ログイン エンドポイントは、本文に ID トークン値を含む credential パラメータを含む POST リクエストを処理する必要があります。

詳しくは、次の表をご覧ください。

タイプ 省略可 例
URL デフォルトは、現在のページの URI または指定した値です。
data-ux_mode="popup" と data-callback が設定されている場合は無視されます。
data-login_uri="https://www.example.com/login"

データ コールバック

この属性は、返された ID トークンを処理する JavaScript 関数の名前です。詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 data-login_uri が設定されていない場合は必須です。 data-callback="handleToken"

data-login_uri 属性と data-callback 属性のいずれかが使用される場合があります。これは、次のコンポーネントと UX モードの構成によって異なります。

  • data-login_uri 属性は、「Google でログイン」ボタンの redirect UX モードで必須です。このモードでは、data-callback 属性は無視されます。

  • Google ワンタップと Google ログインボタンの popup UX モードでは、これら 2 つの属性のいずれかを設定する必要があります。両方が設定されている場合は、data-callback 属性が優先されます。

名前空間内の JavaScript 関数は、HTML API ではサポートされていません。代わりに、名前空間のないグローバル JavaScript 関数を使用します。たとえば、mylib.callback ではなく mylibCallback を使用します。

コールバック関数には、パラメータとして CredentialResponse オブジェクトが渡されます。設定可能なレスポンス値の詳細については、CredentialResponse をご覧ください。

data-native_login_uri

この属性は、パスワード認証情報ハンドラ エンドポイントの URL です。data-native_login_uri 属性または data-native_callback 属性を設定すると、Google セッションがない場合、JavaScript ライブラリは組み込みの認証情報マネージャーにフォールバックします。data-native_callback 属性と data-native_login_uri 属性の両方を設定することはできません。詳細については、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-login_uri="https://www.example.com/password_login"

data-native_callback

この属性は、ブラウザの組み込み認証情報マネージャーから返されたパスワード認証情報を処理する JavaScript 関数の名前です。data-native_login_uri 属性または data-native_callback 属性を設定すると、Google セッションがない場合、JavaScript ライブラリは組み込みの認証情報マネージャーにフォールバックします。data-native_callback と data-native_login_uri の両方を設定することはできません。詳細については、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-native_callback="handlePasswordCredential"

名前空間内の JavaScript 関数は、HTML API ではサポートされていません。代わりに、名前空間のないグローバル JavaScript 関数を使用します。たとえば、mylib.callback ではなく mylibCallback を使用します。

data-native_id_param

パスワード認証情報をパスワード認証情報ハンドラ エンドポイントに送信するときに、credential.id フィールドのパラメータ名を指定できます。デフォルト名は email です。詳しくは、次の表をご覧ください。

タイプ 必須 例
URL 省略可 data-native_id_param="user_id"

data-native_password_param

パスワード認証情報をパスワード認証情報ハンドラ エンドポイントに送信するときに、credential.password 値のパラメータ名を指定できます。デフォルト名は password です。詳しくは、次の表をご覧ください。

タイプ 必須 例
URL 省略可 data-native_password_param="pwd"

data-cancel_on_tap_outside

この属性は、ユーザーがプロンプトの外側をクリックした場合にワンタップ リクエストをキャンセルするかどうかを設定します。デフォルト値は true です。無効にするには、値を false に設定します。詳しくは、次の表をご覧ください。

タイプ 必須 例
ブール値 省略可 data-cancel_on_tap_outside="false"

data-prompt_parent_id

この属性は、コンテナ要素の DOM ID を設定します。設定されていない場合、ワンタップ プロンプトはウィンドウの右上隅に表示されます。詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-prompt_parent_id="parent_id"

Cookie を使用して、ワンタップ プロンプトの表示を制御します。この属性で指定された Cookie に空でない値がある場合、プロンプトは表示されません。詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-skip_prompt_cookie="SID"

data-nonce

この属性は、リプレイ攻撃を防ぐために ID トークンで使用されるランダムな文字列です。詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-nonce="biaqbm70g23"

ノンスの長さは、環境でサポートされている JWT の最大サイズと、個々のブラウザとサーバーの HTTP サイズの制約に制限されます。

data-essential_claims

この属性は、Google から返される ID トークンに含める追加のクレームをリクエストするために使用される文字列です。Google で受け入れられるクレームの完全なリストについては、サポートされているクレームをご覧ください。

詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-essential_claims="auth_time, amr"

data-context

このフィールドは、ワンタップ プロンプトに表示されるタイトルとメッセージのテキストを変更します。ITP ブラウザには影響しません。デフォルトは signin です。

詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-context="use"

次の表に、使用可能なすべてのコンテキストとその説明を示します。

コンテキスト
signin 「ログイン」
signup 「登録する」
use 「使用」

data-moment_callback

この属性は、プロンプト UI ステータス通知リスナーの関数名です。詳細については、データ型 PromptMomentNotification をご覧ください。

詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-moment_callback="logMomentNotification"

名前空間内の JavaScript 関数は、HTML API ではサポートされていません。代わりに、名前空間のないグローバル JavaScript 関数を使用します。たとえば、mylib.callback ではなく mylibCallback を使用します。

親ドメインとそのサブドメインでワンタップを表示する必要がある場合は、この属性に親ドメインを渡して、単一の共有状態 Cookie が使用されるようにします。詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-state_cookie_domain="example.com"

data-ux_mode

この属性は、[Google でログイン] ボタンで使用される UX フローを設定します。デフォルト値は popup です。この属性は、ワンタップ UX には影響しません。詳細については、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-ux_mode="redirect"

次の表に、利用可能な UX モードとその説明を示します。

UX モード
popup ポップアップ ウィンドウでログイン UX フローを実行します。
redirect フルページ リダイレクトによってログイン UX フローを実行します。

data-allowed_parent_origin

中間 iframe の埋め込みを許可されているオリジン。この属性が存在する場合、ワンタップは中間 iframe モードで実行されます。詳細については、次の表をご覧ください。

タイプ 必須 例
文字列または文字列配列 省略可 data-allowed_parent_origin="https://example.com"

次の表に、サポートされている値の型とその説明を示します。

値のタイプ
string 単一のドメイン URI。 "https://example.com"
string array ドメイン URI のカンマ区切りのリスト。 "https://news.example.com,https://local.example.com"

data-allowed_parent_origin 属性の値が無効な場合、中間 iframe モードのワンタップ初期化は失敗して停止します。

ワイルドカード接頭辞もサポートされています。たとえば、"https://*.example.com" は example.com とそのすべてのレベルのサブドメイン(news.example.com、login.news.example.com など)に一致します。ワイルドカードを使用する際の注意事項は次のとおりです。

  • パターン文字列をワイルドカードとトップレベル ドメインのみで構成することはできません。たとえば、https://.com と https://.co.uk は無効です。"https://.example.com" は example.com とそのすべてのサブドメインに一致するためです。2 つの異なるドメインを表すには、カンマ区切りのリストを使用します。たとえば、"https://example1.com,https://.example2.com" は、ドメイン example1.com、example2.com、example2.com のサブドメインと一致します。
  • ワイルドカード ドメインは安全な https:// スキームで始まる必要があるため、"*.example.com" は無効と見なされます。

data-intermediate_iframe_close_callback

ユーザーがワンタップ UI の [X] ボタンをタップしてワンタップを手動で閉じた場合の、デフォルトの中間 iframe の動作をオーバーライドします。デフォルトの動作では、中間 iframe は DOM からすぐに削除されます。

data-intermediate_iframe_close_callback フィールドは、中間 iframe モードでのみ有効になります。また、ワンタップ iframe ではなく、中間 iframe にのみ影響します。コールバックが呼び出される前に、ワンタップ UI が削除されます。

タイプ 必須 例
関数 省略可 data-intermediate_iframe_close_callback="logBeforeClose"

名前空間内の JavaScript 関数は、HTML API ではサポートされていません。代わりに、名前空間のないグローバル JavaScript 関数を使用します。たとえば、mylib.callback ではなく mylibCallback を使用します。

data-itp_support

このフィールドは、Intelligent Tracking Prevention(ITP)をサポートするブラウザでアップグレードされたワンタップ UX を有効にするかどうかを決定します。デフォルト値は false です。詳しくは、次の表をご覧ください。

タイプ 必須 例
ブール値 省略可 data-itp_support="false"

data-login_hint

どのユーザーがログインする必要があるかをアプリが事前に把握している場合は、Google にログインヒントを提供できます。成功すると、アカウントの選択はスキップされます。指定できる値は、メールアドレスまたは ID トークンの sub フィールドです。

詳細については、login_hint の OpenID Connect のドキュメントをご覧ください。

タイプ 必須 例
文字列。メールアドレスまたは ID トークンの sub フィールド値を指定できます。 省略可 data-login_hint="elisa.beckett@gmail.com"

data-hd

ユーザーが複数のアカウントを持っていて、Workspace アカウントでのみログインする必要がある場合は、これを使用して Google にドメイン名のヒントを提供します。成功すると、アカウントの選択時に表示されるユーザー アカウントは、指定されたドメインに制限されます。ワイルドカード値: * は、アカウントの選択時にユーザーに Workspace アカウントのみを提供し、一般ユーザー向けアカウント(user@gmail.com)を除外します。

詳細については、hd の OpenID Connect のドキュメントをご覧ください。

タイプ 必須 例
文字列。完全修飾ドメイン名または *。 省略可 data-hd="*"

data-use_fedcm_for_prompt

ブラウザがユーザーのログイン プロンプトを制御し、ウェブサイトと Google の間のログインフローを仲介できるようにします。デフォルトは false です。詳細については、FedCM への移行のページをご覧ください。

タイプ 必須 例
ブール値 非推奨 data-use_fedcm_for_prompt="true"

data-use_fedcm_for_button

このフィールドは、Chrome(デスクトップ M125 以降、Android M128 以降)で FedCM ボタン UX を使用するかどうかを決定します。デフォルトは false です。詳しくは、次の表をご覧ください。

タイプ 必須 例
ブール値 省略可 data-use_fedcm_for_button="true"

data-button_auto_select

このフィールドは、FedCM ボタンフローの自動選択オプションを有効にするかどうかを決定します。有効にすると、アクティブな Google セッションを持つリピーターは、Account Chooser のプロンプトをバイパスして自動的にログインします。デフォルトは false ですオプトインのリリース時に、ボタンの自動ログインを明示的に有効にする必要があります。詳しくは、次の表をご覧ください。

タイプ 必須 例
ブール値 省略可 data-button_auto_select="true"

クラス「g_id_signin」の要素

要素の class 属性に g_id_signin を追加すると、要素は「Google でログイン」ボタンとしてレンダリングされます。

同じページに複数の「Google でログイン」ボタンをレンダリングできます。各ボタンに独自のビジュアル設定を適用できます。設定は、次のデータ属性によって定義されます。

視覚的データ属性

次の表に、ビジュアル データ属性とその説明を示します。

属性
data-type ボタンのタイプ: アイコンまたは標準ボタン。
data-theme ボタンのテーマ。たとえば、filled_blue や filled_black です。
data-size ボタンのサイズ。例: 小、大。
data-text ボタンのテキスト。たとえば、「Google でログイン」や「Google で登録」などです。
data-shape ボタンの形状。(長方形、円形など)。
data-logo_alignment Google ロゴの配置: 左または中央。
data-width ボタンの幅(ピクセル単位)。
data-locale ボタンのテキストは、この属性で設定された言語で表示されます。
data-click_listener 設定すると、[Google でログイン] ボタンがクリックされたときにこの関数が呼び出されます。
data-state 設定されている場合、この文字列は ID トークンとともに返されます。

属性タイプ

以降のセクションでは、各属性のタイプと例について詳しく説明します。

data-type

ボタンのタイプ。デフォルト値は standard です。詳細については、次の表をご覧ください。

タイプ 必須 例
文字列 はい data-type="icon"

次の表に、使用可能なすべてのボタンタイプとその説明を示します。

タイプ
standard
テキストまたはパーソナライズされた情報を含むボタン。
icon
テキストのないアイコンボタン。

data-theme

ボタンのテーマ。デフォルト値は outline です。詳細については、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-theme="filled_blue"

次の表に、使用可能なテーマとその説明を示します。

テーマ サンプル 仕様
outline
standard-button-white icon-button-white personalized-button-white
標準のボタンテーマ。
塗りつぶし: #FFFFFF
ストローク: #747775 | 1px | 内側
フォント: #1F1F1F | Roboto Medium | 14/20
パーソナライズ: #1F1F1F | Roboto | Medium 12/14 | Regular 11/13
filled_blue
青で塗りつぶされたボタンのテーマ。
塗りつぶし: #0B57D0
ストローク: #OB57D0 | 1px | 内側
フォント: #FFFFFF | Google Sans Medium | 14/20
パーソナライズ: #FFFFFF | Roboto | Medium 12/14 | Regular 11/13
filled_black
黒で塗りつぶされたボタンテーマと、対照的なロゴ。
塗りつぶし: #202124
ストローク: #OB57D0 | 1px | 内側
フォント: #FFFFFF | Google Sans Medium | 14/20
パーソナライズ: #FFFFFF | Roboto | Medium 12/14 | Regular 11/13
outline_dark
黒で塗りつぶされたボタンのテーマ。
塗りつぶし: #131314
ストローク: #8E918F | 1px | 内側
フォント: #FFFFFF | Google Sans Medium | 14/20
パーソナライズ: #FFFFFF | Roboto | Medium 12/14 | Regular 11/13

データサイズ

ボタンのサイズ。デフォルト値は large です。詳細については、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-size="small"

次の表に、使用可能なボタンサイズとその説明を示します。

サイズ
large
大きな標準ボタン 大きなアイコンボタン パーソナライズされた大きなボタン
大きなボタン。
medium
中サイズの標準ボタン 中サイズのアイコンボタン
中サイズのボタン。
small
小さなログインボタン 小さなアイコンボタン
小さなボタン。

data-text

ボタンのテキスト。デフォルト値は signin_with です。data-text 属性が異なるアイコンボタンのテキストに視覚的な違いはありません。唯一の例外は、画面のユーザー補助のためにテキストが読み上げられる場合です。

詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-text="signup_with"

次の表に、使用可能なボタンテキストとその説明を示します。

テキスト
signin_with
「Google でログイン」というラベルの標準ボタン テキストが表示されていないアイコンボタン
ボタンのテキストは「Google でログイン」です。
signup_with
「Google で登録」というラベルの標準ボタン テキストが表示されていないアイコンボタン
ボタンのテキストは「Google で登録」です。
continue_with
「Google で続行」というラベルの標準ボタン テキストが表示されていないアイコンボタン
ボタンのテキストは「Google で続ける」です。
signin
「ログイン」というラベルの標準ボタン テキストが表示されていないアイコンボタン
ボタンのテキストは「ログイン」です。

data-shape

ボタンの形状。デフォルト値は rectangular です。詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-shape="rectangular"

次の表に、使用可能なボタンの形状とその説明を示します。

図形
rectangular
長方形の標準ボタン 長方形のアイコンボタン 長方形のパーソナライズされたボタン
長方形のボタン。icon ボタンタイプに使用する場合、square と同じです。
pill
ピル型の標準ボタン ピル型のアイコンボタン パーソナライズされたピル型のボタン
ピル型のボタン。icon ボタンタイプに使用される場合、circle と同じです。
circle
円形の標準ボタン 円形のアイコンボタン 円形のパーソナライズされたボタン
円形のボタン。standard ボタンタイプに使用する場合は、pill と同じです。
square
四角い標準ボタン 四角いアイコンボタン 四角形のパーソナライズされたボタン
四角いボタン。standard ボタンタイプに使用する場合は、rectangular と同じです。

data-logo_alignment

Google ロゴの配置。デフォルト値は left です。この属性は、standard ボタンタイプにのみ適用されます。詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-logo_alignment="center"

次の表に、使用可能なアライメントとその説明を示します。

logo_alignment
left
左側に G ロゴがある標準ボタン
Google ロゴを左揃えにします。
center
中央に G ロゴがある標準ボタン
Google ロゴを中央揃えにします。

data-width

ボタンの最小幅(ピクセル単位)。使用可能な最大幅は 400 ピクセルです。

詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-width=400

data-locale

省略可。指定された言語 / 地域を使用してボタンのテキストを表示します。指定されていない場合は、ユーザーの Google アカウントまたはブラウザ設定がデフォルトで使用されます。ライブラリを読み込むときに、hl パラメータと言語コードを src ディレクティブに追加します(例: gsi/client?hl=<iso-639-code>)。

設定されていない場合は、ブラウザのデフォルトのロケールまたは Google セッション ユーザーの設定が使用されます。そのため、ユーザーによって、ローカライズされたボタンのバージョンが異なる場合や、サイズが異なる場合があります。

詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-locale="zh_CN"

data-click_listener

data-click_listener 属性を使用して、[Google でログイン] ボタンがクリックされたときに呼び出される JavaScript 関数を定義できます。

  <script>
    function onClickHandler(){
      console.log("Sign in with Google button clicked...")
    }
  </script>
  .....
  <div class="g_id_signin"
      data-size="large"
      data-theme="outline"
      data-click_listener="onClickHandler">
  </div>

この例では、[Google でログイン] ボタンがクリックされると、メッセージ「Sign in with Google button clicked...」がコンソールに記録されます。

data-state

省略可。同じページに複数の「Google でログイン」ボタンをレンダリングできるため、各ボタンに一意の文字列を割り当てることができます。同じ文字列が ID トークンとともに返されるため、ユーザーがログインするためにクリックしたボタンを識別できます。

詳しくは、次の表をご覧ください。

タイプ 必須 例
文字列 省略可 data-state="button 1"

サーバーサイドの統合

サーバーサイドのエンドポイントは、次の HTTP POST リクエストを処理する必要があります。

ID トークン ハンドラ エンドポイント

ID トークン ハンドラ エンドポイントは、ID トークンを処理します。対応するアカウントのステータスに基づいて、ユーザーをログインさせ、登録ページに誘導するか、アカウント リンクページに誘導して追加情報を取得します。クライアントは、認識できないレスポンス パラメータを無視する必要があります。

ログイン エンドポイントへのリクエストの例:

POST /login HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Cookie: g_csrf_token=<RANDOM_STRING>
Host: www.example.com

credential=<JWT_ENCODED_ID_TOKEN>&g_csrf_token=<RANDOM_STRING>

HTTP POST リクエストには、次の情報が含まれます。

形式 名前 説明
Cookie g_csrf_token data-login_uri で指定されたログイン エンドポイントへのリクエストごとに変化するランダムな文字列。g_csrf_token リクエスト パラメータの値と一致する必要があります。
リクエスト パラメータ g_csrf_token data-login_uri で指定されたログイン エンドポイントへのリクエストごとに変化するランダムな文字列。g_csrf_token Cookie の値と一致する必要があります。
リクエスト パラメータ credential Google が発行するエンコードされた JWT ID トークン。
リクエスト パラメータ state このパラメータは、ユーザーが [Google でログイン] ボタンをクリックしてログインし、ボタンの state 属性が指定されている場合にのみ定義されます。

認証情報

デコードされた ID トークンは、次の例のようになります。

header
{
  "alg": "RS256",
  "kid": "f05415b13acb9590f70df862765c655f5a7a019e", // JWT signature
  "typ": "JWT"
}
payload
{
  "iss": "https://accounts.google.com", // The JWT's issuer
  "nbf":  161803398874,
  "aud": "314159265-pi.apps.googleusercontent.com", // Your server's client ID
  "sub": "3141592653589793238", // The unique ID of the user's Google Account
  "hd": "gmail.com", // If present, the host domain of the user's Google Workspace email address
  "auth_time": 1748875426,
  "amr": ["mfa", "pwd", "tel"],
  "email": "elisa.g.beckett@gmail.com", // The user's email address
  "email_verified": true, // true, if Google has verified the email address
  "azp": "314159265-pi.apps.googleusercontent.com",
  "name": "Elisa Beckett",
                            // If present, a URL to user's profile picture
  "picture": "https://lh3.googleusercontent.com/a-/e2718281828459045235360uler",
  "given_name": "Eliza",
  "family_name": "Beckett",
  "iat": 1596474000, // Unix timestamp of the assertion creation time
  "exp": 1596477600, // Unix timestamp of the assertion expiration time
  "jti": "abc161803398874def"
}

クライアントは、認識されない JWT クレームを無視する必要があります。

sub フィールドは、Google アカウントのグローバルに一意の識別子です。sub フィールドは、すべての Google アカウントで一意であり、再利用されることはないため、ユーザーの識別子としてのみ使用します。

email、email_verified、hd フィールドを使用すると、Google がメールアドレスをホストし、そのメールアドレスに対して権限を持っているかどうかを判断できます。Google が権限を持つ場合、ユーザーは正当なアカウント所有者であることが確認されます。

Google が権限を持つケース:

  • email の末尾が @gmail.com の場合、これは Gmail アカウントです。
  • email_verified が true で、hd が設定されている場合、これは Google Workspace アカウントです。

ユーザーは、Gmail や Google Workspace を使用せずに Google アカウントに登録できます。email に @gmail.com 接尾辞が含まれておらず、hd がない場合、Google は信頼できる情報源ではないため、ユーザーの確認にはパスワードやその他のチャレンジ方法を使用することをおすすめします。email_verified も true になる可能性があります。これは、Google アカウントの作成時に Google がユーザーを最初に確認したものの、サードパーティのメール アカウントの所有権が変更された可能性があるためです。

exp フィールドには、サーバー側でトークンを検証するための有効期限が表示されます。「Google でログイン」から取得した ID トークンの場合は 1 時間です。有効期限が切れる前にトークンを検証する必要があります。セッション管理に exp を使用しないでください。ID トークンの有効期限が切れても、ユーザーがログアウトしたことにはなりません。アプリは、ユーザーのセッション管理を担当します。

g_csrf_token

偽造防止状態トークン。これは、gsi/client ライブラリによって作成されたクロスサイト リクエスト フォージェリ(CSRF)トークンです。ランダムな値が Cookie とリクエスト パラメータの両方として POST ペイロード本文に含まれます。サーバーでリクエストを処理するときに、これら 2 つの値が一致しない場合、リクエストは無効と見なされます。

state

このパラメータは、ユーザーが [Google でログイン] ボタンをクリックしてログインし、クリックされたボタンの data-state 属性が指定されている場合にのみ定義されます。このフィールドの値は、ボタンの data-state 属性で指定した値と同じです。

同じページに複数の「Google でログイン」ボタンをレンダリングできるため、各ボタンに一意の文字列を割り当てることができます。したがって、この state パラメータを使用して、ユーザーがログインするためにクリックしたボタンを識別できます。

パスワード認証情報ハンドラ エンドポイント

パスワード認証情報ハンドラ エンドポイントは、組み込みの認証情報マネージャーが取得したパスワード認証情報を処理します。

HTTP POST リクエストには、次の情報が含まれます。

形式 名前 説明
Cookie g_csrf_token data-native_login_uri で指定されたログイン エンドポイントへのリクエストごとに変化するランダムな文字列。g_csrf_token リクエスト パラメータの値と一致する必要があります。
リクエスト パラメータ g_csrf_token data-native_login_uri で指定されたログイン エンドポイントへのリクエストごとに変化するランダムな文字列。g_csrf_token Cookie の値と一致する必要があります。
リクエスト パラメータ email Google が発行する ID トークン。
リクエスト パラメータ password 認証情報の選択方法。