アプリ切り替え

OAuth 2.0 を実装すると、必要に応じて認証ベースの App Flip を構成できます。これにより、ユーザーは認証システム内のアカウントを Google アカウントにすばやくリンクできます。以降のセクションでは、smart home アクションの App Flip を設計して実装する方法について説明します。

設計ガイドライン

このセクションでは、アプリ切り替えアカウント リンクの同意画面の設計要件と推奨事項について説明します。Google がアプリを呼び出した後、アプリは同意画面をユーザーに表示します。

要件

  1. 「リンクすると、Google はデバイスを管理する権限を Google に付与する」といった Google の承認文言が必要です。
  2. ユーザーのアカウントが Google にリンクしていることをお客様に伝える必要があります。Google Home や Google アシスタントなどの特定の Google プロダクトにリンクしないようにしてください。
  3. 同意画面に行動を促す明確なフレーズを明記し、リンク アクションには「同意してリンク」という文言を使用する必要があります。アカウントをリンクするために Google と共有する必要があるデータをユーザーが理解する必要があるためです。
  4. ユーザーがリンクをしなかった場合は、戻るまたはキャンセルできる方法を提供する必要があります。キャンセル アクションには「キャンセル」を使用します。
  5. このワークフローを実装する必要があります。[同意してリンクする] をクリックした後、リンクの成功を示し、ユーザーを Google Home アプリに自動的にリダイレクトする必要があります。Google Home アプリに、アクションを行ったリンク済みデバイスが表示されます。[キャンセル] をクリックすると、ユーザーを Google Home アプリにリダイレクトする必要があります。

推奨事項

次の手順を行うことをおすすめします。

  1. Google のプライバシー ポリシーを表示します。同意画面に Google のプライバシー ポリシーへのリンクを含めます。

  2. 共有されるデータ。明確で簡潔な表現を使用して、Google が必要とするデータとその理由をユーザーに伝えます。

  3. リンク解除できます。プラットフォーム上のアカウント設定への URL など、ユーザーがリンクを解除するためのメカニズムを提供します。また、リンクされたアカウントを管理できる Google アカウントへのリンクを含めることもできます。

  4. ユーザー アカウントを変更できます。ユーザーがアカウントを切り替える方法を提案する。これは、ユーザーが複数のアカウントを持つ傾向がある場合に特に便利です。

    • ユーザーが同意画面を閉じてアカウントを切り替える必要がある場合は、回復可能なエラーを Google に送信します。これにより、ユーザーは OAuth リンク暗黙的フローを使用して、目的のアカウントにログインできます。
  5. ロゴを含める。同意画面に会社のロゴを表示する。 スタイル ガイドラインに沿ってロゴを配置します。Google のロゴも表示する場合は、ロゴと商標をご覧ください。

この図は、同意画面の例を示しています。ユーザー同意画面をデザインする際に、個々の要件と推奨事項がコールアウトで示されています。
図 1: アカウントのリンクの同意画面のデザイン ガイドライン

OAuth ベースの App Flip 用の設定

以降のセクションでは、OAuth ベースの App Flip の前提条件と、Actions Console で App Flip プロジェクトを構成する方法について説明します。

スマートホーム アクションを作成して OAuth 2.0 サーバーを設定する

App Flip を構成する前に、次のことを行う必要があります。

Actions Console で App Flip を構成する

次のセクションでは、Actions ConsoleApp Flip を構成する方法について説明します。

  1. [OAuth Client information] のすべてのフィールドを入力します(App Flip がサポートされていない場合は、通常の OAuth がフォールバックとして使用されます)。
  2. [Use your app for account linking (optional)] で、[Enable for iOS](iOS で有効にする)をオンにします。
  3. [Universal Link](ユニバーサル リンク)フィールドに入力します。ユニバーサル リンクについて詳しくは、アプリやウェブサイトのコンテンツへのリンクを許可するをご覧ください。
  4. クライアントを設定したい場合は、スコープを追加し、[Configure your client (optional)](クライアントを構成する(省略可))で [Add scope](スコープを追加)をクリックします。
  5. [保存] をクリックします。

次のセクションに進んで、iOS アプリまたは Android アプリに App Flip を実装できます。

ネイティブ アプリに App Flip を実装する

App Flip を実装するには、Google からのディープリンクを受け入れるように、アプリ内のユーザー認証コードを変更する必要があります。

デバイスで App Flip をテストする

アクションを作成し、コンソールとアプリで App Flip を構成したので、モバイル デバイスで App Flip をテストできます。Google Assistant app または Google Home app (GHA) を使用して App Flip をテストできます。

Google Assistant app から App Flip をテストするには、次の手順を行います。

  1. Actions Console に移動して、プロジェクトを選択します。
  2. 上部のナビゲーションで [Test](テスト)をクリックします。
  3. Google Assistant アプリからアカウントのリンクのフローをトリガーします。
    1. Google Assistant app を開きます。
    2. [設定] をクリックします。
    3. [Assistant] タブで、[スマートホーム] をクリックします。
    4. [追加(+)] をクリックします。
    5. プロバイダのリストからアクションを選択します。リストの先頭に「[test]」が付きます。リストから [test] アクションを選択する場合、アプリを開く必要があります。
    6. アプリが起動したことを確認し、承認フローのテストを開始します。

Google Home アプリから App Flip をテストする手順は次のとおりです。

  1. Actions Console に移動して、プロジェクトを選択します。
  2. 上部のナビゲーションで [Test](テスト)をクリックします。
  3. Home アプリからアカウントのリンクのフローをトリガーします。
    1. Google Home app (GHA) を開きます。
    2. [+] ボタンをクリックします。
    3. [デバイスのセットアップ] をクリックします。
    4. [セットアップ済みデバイスのリンク] をクリックします。
    5. プロバイダのリストから smart home アクションを選択します。リストの先頭に「[test]」が付きます。リストから [test] アクションを選択する場合、アプリを開く必要があります。
    6. アプリが起動したことを確認し、承認フローのテストを開始します。