アプリ切り替え

OAuth 2.0 の実装が完了したら、必要に応じて 認証ベースの App Flip: ユーザーがより迅速に 認証システムでそれらのユーザーのアカウントを Google アカウントにリンクします。「 以降のセクションでは、Google Cloud 向けの 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 を設定する

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

  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 またはアプリに App Flip を実装できます。 Android アプリ。

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

App Flip を実装するには、ユーザー認証コードを アプリで Google からのディープリンクを受け付けます。

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

これで、アクションを作成し、コンソールとコンソールで App Flip を構成しました。 モバイル デバイスで App Flip をテストできます。こちらの App Flip をテストするには、Google Assistant app または Google Home app (GHA)

Google Assistant app から App Flip をテストする手順は次のとおりです。

  1. Actions Console に移動して、プロジェクトを選択します。
  2. 上部のナビゲーションで [Test](テスト)をクリックします。
  3. Google Assistant アプリからアカウントのリンクフローをトリガーします。
    1. アプリ Google Assistant app
    2. [設定] をクリックします。
    3. [Assistant] タブで [Home Control] をクリックします。
    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. アプリが起動したことを確認し、承認フローのテストを開始します。