ディープリンク

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

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

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

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

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

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

現在のところ、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 のドキュメントをご覧ください。