App Discovery とディープリンク

Google Home app (GHA) は、ユーザーがスマート デバイスを Google Assistantして次のストラクチャと部屋に割り当てる Google Home Graph。 通常、スマートホーム デバイスをセットアップするためには、複数の画面を順番に移動し、利用可能なオプションの中から smart home アクションを選択します。しかし、ユーザーがもっと簡単にセットアップできるようにすれば、オンボーディングがより迅速になり、セットアップに関するユーザーの不満も軽減できます。

Google smart home プラットフォームには、smart home デバイスのユーザー オンボーディングを合理化するための便利な機能が用意されています。これらの機能を使用してセットアップ フローを簡単にすることで、ユーザーがよりスムーズに smart home デバイスを使い始められるようになります。これらの機能は、コードをほとんど(あるいはまったく)記述しなくても、smart home アクションに簡単に統合できます。

次のリストは、実装できるプラットフォーム機能をまとめたものです。 ユーザーがスマート デバイスをセットアップする際の煩わしさを軽減し、 Assistant:

  • App Discovery: この機能を使用すると、アクションにリンクした候補ワードを GHA に表示できます。ユーザーが候補ワードをクリックすると、サードパーティのプロバイダ アカウントを使用して、smart home デバイスを Assistant に接続できます。
  • ディープリンク: この機能を使用すると、 ユーザーが簡単にリンクや smart home 台のデバイスを Assistant にマッピング。 ユーザーがディープリンクをクリックすると、GHA のダウンロード(まだインストールされていない場合)を求めるメッセージが表示され、アカウントのリンクと部屋の割り当てを設定するためのフローが始まります。

App Discovery を実装する

ブランド確認プロセスが完了していれば、Actions on Google Console から App Discovery 機能を有効にできます。コード変更は必要ありませんが、smart home アクションが審査済みで、すでに本番環境で稼働している必要があります。

Actions Console にログインします。

Actions on Google コンソールに移動

  1. smart home アクション プロジェクトを開きます。
  2. [Deploy](デプロイ)> [Brand Verification](ブランドの確認)をクリックします。
  3. 次の手順に沿って、会社のウェブサイトを Actions プロジェクトに接続します。
    1. [Websites](ウェブサイト)パネルで、[Connect site](サイトを接続)をクリックします。
    2. 接続したいウェブサイトの URL を入力して、[Connect](接続)をクリックします。 Google からウェブサイトの所有者に、ウェブサイトの関連付けを確認するメールが送信されます。
  4. [Android apps](Android アプリ)パネルで [Connect app](アプリを接続)ボタンをクリックし、表示される手順に従います。

  5. 同じパネルで、アプリの [Enable app Discovery] オプションをオンに切り替えます。 接続アプリ。このオプションは、アクションが完了するまでグレー表示されます。 審査されて承認されました。

Google Home へのディープリンクを設定する

ディープリンクを使用すると、Android アプリや iOS アプリから、GHA 内の特定のリンク先に直接移動できます。これにより、Assistant を使用してデバイスを簡単にセットアップできるようになります。

GHA ディープリンクの構文は次のとおりです。

https://home.google.com/home-app/?deeplink=destination

現在のところ、Android アプリまたは iOS アプリから直接移動できる GHA 内のリンク先は次のとおりです。

目的地 説明
setup/ha_linking?agent_id=agent-id を開始する 指定された smart home に対する OAuth アカウントのリンクフロー アクションの agent-id

宛先のパスは URL エンコード 適用する前に例:

https://home.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id

アプリ内からディープリンクをトリガーする方法について詳しくは、 Android ドキュメント および iOS ドキュメントをご覧ください