ディープリンク

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

ディープリンクを使用すると、アプリや製品サイトにディープリンクを埋め込むことで、ユーザーが smart home デバイスを Assistant に簡単に接続できるようになります。ユーザーがディープリンクをクリックすると、GHA のダウンロード(まだインストールされていない場合)を求めるメッセージが表示され、アカウントのリンクと部屋の割り当てを設定するためのフローが始まります。

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

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

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

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

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

目的地 説明
setup/ha_linking?agent_id=agent-id 指定した Cloud-to-cloud 統合の agent-id OAuth アカウントのリンクフローを開始します。

リンク先パスは、ディープリンクに適用する前に URL エンコードする必要があります。次に例を示します。

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

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