[Google でログイン] ボタンを表示する

サイトに [Google でログイン] ボタンを追加して、ユーザーがウェブアプリに登録またはログインできるようにします。HTML または JavaScript を使用してボタンをレンダリングし、属性を使用してボタンの形状、サイズ、テキスト、テーマをカスタマイズします。

パーソナライズされたログインボタン。

ユーザーが Google アカウントを選択して同意すると、Google が JSON Web Token（JWT）を使用してユーザー プロファイルを認証します。各ステップの概要については ログインやユーザー エクスペリエンスに関連する要素について詳しくは、仕組みをご覧ください。 パーソナライズされたボタンについてでは、ボタンがユーザーに表示される仕組みに影響するさまざまな条件と状態について説明します。

前提条件

ログイン ページにボタンを追加する前に、以下を完了してください。

ボタンのレンダリング

[Google でログイン] ボタンを表示するには、HTML または JavaScript を選択して、ログインページにボタンをレンダリングします。

HTML

HTML を使用してログインボタンをレンダリングし、JWT をプラットフォームのログイン エンドポイントに返します。

<html>
  <body>
    <script src="https://accounts.google.com/gsi/client" async></script>
    <div id="g_id_onload"
        data-client_id="YOUR_GOOGLE_CLIENT_ID"
        data-login_uri="https://your.domain/your_login_endpoint"
        data-auto_prompt="false">
    </div>
    <div class="g_id_signin"
        data-type="standard"
        data-size="large"
        data-theme="outline"
        data-text="sign_in_with"
        data-shape="rectangular"
        data-logo_alignment="left">
    </div>
  <body>
</html>

g_id_signin クラスの要素が「Google でログイン」ボタンとしてレンダリングされます。 ボタンは、データ属性で指定されたパラメータによってカスタマイズされます。

同じページに「Google でログイン」ボタンと Google One Tap を表示するには、data-auto_prompt="false" を削除します。そうすれば、手間を減らして ログイン率を向上できます。

データ属性の完全なリストについては、g_id_signin リファレンスのページをご覧ください。

JavaScript

JavaScript を使用してログインボタンをレンダリングし、JWT をブラウザの JavaScript コールバック ハンドラに返します。

<html>
  <body>
    <script src="https://accounts.google.com/gsi/client" async></script>
    <script>
      function handleCredentialResponse(response) {
        console.log("Encoded JWT ID token: " + response.credential);
      }
      window.onload = function () {
        google.accounts.id.initialize({
          client_id: "YOUR_GOOGLE_CLIENT_ID"
          callback: handleCredentialResponse
        });
        google.accounts.id.renderButton(
          document.getElementById("buttonDiv"),
          { theme: "outline", size: "large" }  // customization attributes
        );
        google.accounts.id.prompt(); // also display the One Tap dialog
      }
    </script>
    <div id="buttonDiv"></div>
  </body>
</html>

renderButton の最初のパラメータとして指定された要素は、[Google でログイン] ボタンとして表示されます。この例では、buttonDiv を使用してレンダリングを行います。 クリックします。ボタンは、renderButton の 2 番目のパラメータで指定された属性を使用してカスタマイズされます。

ユーザーの負担を最小限に抑えるため、表示のために google.accounts.id.prompt() が呼び出されます。 ボタンによる登録やログインに代わる別の方法として、ワンタップを使用できます。

GIS ライブラリは HTML ドキュメントを解析し、ID 属性が g_id_onload、または g_id_signin を含むクラス属性。一致する要素が見つかった場合、JavaScript でボタンをレンダリングしているかどうかにかかわらず、ボタンは HTML を使用してレンダリングされます。ボタンが 2 回表示されないようにするには、パラメータが競合する可能性があるため、これらの名前に一致する HTML 要素を HTML ページに含めないでください。

ボタンの言語

ボタンの言語は、ブラウザのデフォルト言語または Google セッション ユーザーの設定によって自動的に決まります。ライブラリを読み込むときに hl パラメータと言語コードを src ディレクティブに追加し、オプションの data-locale または locale パラメータ（HTML では data-locale、JavaScript では locale）を追加することで、言語を手動で選択することもできます。

HTML

次のコード スニペットは、クライアント ライブラリの URL に hl パラメータを追加し、data-locale 属性をフランス語に設定して、ボタンの言語をフランス語で表示する方法を示しています。

<script src="https://accounts.google.com/gsi/client?hl=fr" async></script>
<div class="g_id_signin" data-locale="fr">
</div>

JavaScript

次のコード スニペットは、フランス語でボタンの言語を表示する方法を示しています。 クライアント ライブラリの URL に hl パラメータを追加し、 locale パラメータを以下に設定した google.accounts.id.renderButton メソッド フランス語:

<script src="https://accounts.google.com/gsi/client?hl=fr" async></script>
<script>
  google.accounts.id.renderButton(
    document.getElementById("buttonDiv"),
    { locale: "fr" }
  );
</script>

認証情報の処理

ユーザーの同意を得ると、Google は ID トークンと呼ばれる JSON Web Token（JWT）認証情報をユーザーのブラウザまたはプラットフォームがホストするログイン エンドポイントに直接返します。

JWT を受け取る場所は、 HTML または JavaScript。ポップアップまたはリダイレクトの UX モードが使用されているかどうか。

popup UX モードを使用すると、ポップアップ ウィンドウでログイン UX フローが実行されます。これは、 デフォルトの UX モードです。

ボタンをレンダリングする際に、次を使用している場合:

HTML

次のいずれかを設定できます。

  • data-callback で JWT をコールバック ハンドラに返す。または、
  • Google が JWT をログインに直接送信するための data-login_uri POST リクエストを使用してエンドポイントのエンドポイントに直接アクセスできます。

両方の値を設定した場合、data-callback が data-login_uri。コールバックを使用する場合、両方の値を設定すると便利です。 使用します。

JavaScript

callback を指定する必要があります。ポップアップ モードではリダイレクトはサポートされていません 呼び出されることがあります。設定した場合、login_uri は無視されます。

デコードの詳細については、返された認証情報レスポンスを処理するをご覧ください。 JS コールバック ハンドラ内の JWT。

リダイレクト モード

redirect UX モードを使用すると、ユーザーのブラウザの全ページ リダイレクトを使用してログイン UX フローが実行され、Google は POST リクエストを使用して JWT をログイン エンドポイントに直接返します。一般的に、これはユーザーにとってより侵入的なエクスペリエンスですが、最も安全なログイン方法と見なされています。

以下を使用してボタンをレンダリングする場合:

  • HTML では、必要に応じて data-login_uri をログイン エンドポイントの URI に設定します。
  • JavaScript: 必要に応じて、login_uri をログイン エンドポイントの URI に設定します。

値を指定しない場合は、JWT が現在のオブジェクトの URI に返されます。 できます。

ログイン エンドポイントの URI

data-login_uri または login_uri を設定する場合は、HTTPS と絶対 URI を使用します。 例: https://example.com/path

HTTP は、開発中に localhost を使用する場合にのみ許可されます。 http://localhost/path。

Google の要件と検証ルールの詳細については、安全な JavaScript 生成元とリダイレクト URI を使用するをご覧ください。