Google ログインによるアカウントリンク

アシスタント用 Google ログインは、アカウントのリンクやアカウント作成に関するユーザーエクスペリエンスをシンプルかつ簡単にするもので、ユーザーとデベロッパーのどちらにとっても便利です。アクションは、ユーザーとの会話中に、ユーザーの Google プロフィール（ユーザーの名前、メールアドレス、プロフィール写真など）へのアクセスをリクエストできます。

これらのプロフィール情報をアクション内で使用して、ユーザーに合わせてパーソナライズしたエクスペリエンスを作り出すことができます。他のプラットフォームのアプリからでも、そのアプリが Google ログインを使用していれば、既存ユーザーのアカウントを検索してそのアカウントにリンクしたり、新しいアカウントを作成したり、ユーザーと直接やり取りする経路を確立したりすることができます。

Google ログインを使用してアカウントリンクを行うには、ユーザーの Google プロフィールにアクセスすることについてユーザーに同意を求めます。次に、メールアドレスなどのプロフィール情報を使用して、そのユーザーを既存システム内で識別します。

Google ログインによるアカウントリンクを実装する

以降のセクションの手順に従って、Google ログインによるアカウントリンクをアクションに追加します。

プロジェクトを構成する

プロジェクトで Google ログインによるアカウントリンクを使用するよう構成するには、次の手順に従います。

Actions Console を開き、プロジェクトを選択します。
[Develop]（開発）タブをクリックして、[Account linking]（アカウントリンク）を選択します。
[アカウントのリンク] の横にあるスイッチを有効にします。
[Account creation] で、[Yes] を選択します。
[Linking type]（リンクタイプ）で、[Google Sign In]（Google ログイン）を選択します。
[Client Information]（クライアント情報）を開き、[Client ID issued by Google to your Actions]（Google がアクションに対して発行したクライアント ID）の値をメモします。
[保存] をクリックします。

認証フローの音声ユーザーインターフェースを設計する

本人確認が完了しているかどうか確認してアカウントのリンクのフローを開始する

Actions Console で Actions Builder プロジェクトを開きます。
新しいシーンを作成し、アクションでアカウントのリンクを開始します。
1. [Scenes]（シーン）をクリックします。
2. 追加（+）アイコンをクリックして新しいシーンを追加します。
新しく作成したシーンで、[Conditions] の追加アイコンアイコンをクリックします。
会話に関連付けられたユーザーが確認済みユーザーかどうかを確認する条件を追加します。チェックが失敗した場合、アクションは会話中にアカウントリンクを実行できないため、アカウントリンクを必要としない機能にアクセスできるようにフォールバックする必要があります。
1. [Condition] の Enter new expression フィールドに、次のロジックを入力します。 user.verificationStatus != "VERIFIED"
2. [Transition] で、アカウントのリンクが不要なシーン、またはゲスト専用機能のエントリポイントとなるシーンを選択します。

[Conditions] の追加アイコンをクリックします。
ユーザーに ID が関連付けられていない場合に、アカウントのリンクのフローをトリガーする条件を追加します。
1. [Condition] の Enter new expression フィールドに、次のロジックを入力します。 user.verificationStatus == "VERIFIED"
2. [移行] で、[アカウントのリンク] システムシーンを選択します。
3. [保存] をクリックします。

保存後、<SceneName>_AccountLinking という新しいアカウントリンクシステムシーンがプロジェクトに追加されます。

アカウントのリンクのシーンをカスタマイズする

[Scenes]（シーン）で、アカウントリンクのシステムシーンを選択します。
[プロンプトを送信] をクリックし、アクションが ID にアクセスする必要がある理由をユーザーに説明する短い文を追加します（「設定を保存するため」など）。
[保存] をクリックします。

[条件] で [ユーザーがアカウントのリンクを正常に完了した場合] をクリックします。
ユーザーがアカウントのリンクに同意した場合のフローの動作を設定します。たとえば、Webhook を呼び出して必要なカスタムビジネスロジックを処理し、元のシーンに戻ります。
[保存] をクリックします。

[条件] で、[ユーザーがアカウントのリンクをキャンセルまたは拒否した場合] をクリックします。
ユーザーがアカウントのリンクに同意しなかった場合にフローがどのように進むかを構成します。たとえば、確認応答メッセージを送信し、アカウントリンクを必要としない機能を提供するシーンにリダイレクトします。
[保存] をクリックします。

[条件] で [システムエラーまたはネットワークエラーが発生した場合] をクリックします。
システムエラーまたはネットワークエラーが原因でアカウントリンクのフローを完了できない場合のフローの構成。たとえば、確認応答メッセージを送信し、アカウントリンクを必要としない機能を提供するシーンにリダイレクトします。
[保存] をクリックします。

バックエンドのプロフィール情報にアクセスする

ユーザーがアクションに対して自分の Google プロフィールへのアクセスを許可すると、それ以降そのアクションのリクエストが発行されるたびに、ユーザーの Google プロフィール情報を含む Google ID トークンを受け取ります。

ユーザーのプロフィール情報にアクセスするには、まず次の手順に従ってトークンの検証とデコードを行う必要があります。

お使いの言語の JWT デコードライブラリを使用してトークンをデコードし、Google の公開鍵（JWK 形式または PEM 形式で使用可能）を使用してトークンの署名を検証します。
トークンの発行元（デコードされたトークンの iss フィールド）が https://accounts.google.com で、オーディエンス（デコードされたトークンの aud フィールド）が Google がアクションに対して発行したクライアント ID の値（Actions Console でプロジェクトに割り当てられている ID）の値であることを確認します。

デコードされたトークンの例を以下に示します。

{
  "sub": 1234567890,        // The unique ID of the user's Google Account
  "iss": "https://accounts.google.com",        // The token's issuer
  "aud": "123-abc.apps.googleusercontent.com", // Client ID assigned to your Actions project
  "iat": 233366400,         // Unix timestamp of the token's creation time
  "exp": 233370000,         // Unix timestamp of the token's expiration time
  "name": "Jan Jansen",
  "given_name": "Jan",
  "family_name": "Jansen",
  "email": "jan@gmail.com", // If present, the user's email address
  "locale": "en_US"
}

Node.js 用 Actions on Google フルフィルメントライブラリを使用すると、トークンの検証とデコードが自動的に行われ、プロフィールのコンテンツにアクセスできるようになります（以下のコードスニペットを参照）。

...
const app = conversation({
  // REPLACE THE PLACEHOLDER WITH THE CLIENT_ID OF YOUR ACTIONS PROJECT
  clientId: CLIENT_ID,
});
...
// Invoked on successful completion of account linking flow, check if we need to
// create a Firebase user.
app.handle('linkAccount', async conv => {
  let payload = conv.headers.authorization;
  if (payload) {
  // Get UID for Firebase auth user using the email of the user
    const email = payload.email;
    if (!conv.user.params.uid && email) {
      try {
        conv.user.params.uid = (await auth.getUserByEmail(email)).uid;
      } catch (e) {
        if (e.code !== 'auth/user-not-found') {
          throw e;
        }
        // If the user is not found, create a new Firebase auth user
        // using the email obtained from Google Assistant
        conv.user.params.uid = (await auth.createUser({email})).uid;
      }
    }
  }
});

データアクセスリクエストを処理する

データアクセスリクエストを処理するには、Google ID トークンによって識別されたユーザーがすでにデータベースに存在することを確認します。次のコードスニペットは、ユーザーの注文がすでに Firestore データベースに存在するかどうかを確認する方法の例を示しています。

...
app.handle('Place_Order', async conv => {
  const order = conv.session.params.order;
  const userDoc = dbs.user.doc(conv.user.params.uid);
  const orderHistory = userDoc.collection("orderHistory");
  if (orderHistory) {
    // Order history exists, so the user already placed an order.
    // Update counter for order type.
    await orderHistory.doc(order).update({ count: admin.firestore.FieldValue.increment(1)});
  } else {
    // First order they place
    await orderHistory.doc(order).set({ option: order, count: 1});
    options.forEach(opt => {
      if (opt != order) {
        orderHistory.doc(opt).set({ option: opt, count: 0});
      }
    });
  }
  return conv.add(`Your ${order} has been placed. ` +
      'Thanks for using Boba Bonanza, see you soon!');
});

Google ログインによるアカウント リンク