ディープリンク

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

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

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

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

GHA でアカウントのリンクを直接開始するには、次のユニバーサル リンクを使用します。

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

ここで agent-id は、クラウド間連携のプロジェクト ID です。この ID は、Google Home Developer Console のプロジェクト設定で確認できます。

カスタム スキーム（Android と iOS）を使用して起動するモバイル アプリケーションの場合は、次のものも使用できます。

googlehome://setup/ha_linking?agent_id=agent-id

ユーザーがユニバーサル リンクをクリックすると、モバイル プラットフォームが GHAの存在を確認し、アカウントのリンクフローを開きます。ユーザーのデバイスに GHAがインストールされていない場合は、Google Play または Apple App Store からアプリをインストールまたは更新するようにユーザーを誘導する フォールバック処理を提供します。

Android の明示的インテント

明示的インテントを使用して Android アプリケーションからアカウントのリンクフローを直接トリガーするには:

val intent = Intent(Intent.ACTION_VIEW).apply {
    val agentId = "YOUR_AGENT_ID"
    data = Uri.parse("googlehome://setup/ha_linking?agent_id=$agentId")
    setPackage("com.google.android.apps.chromecast.app")
}
try {
    startActivity(intent)
} catch (e: ActivityNotFoundException) {
    // Fallback: open Google Play app, with web browser safety
    try {
        val playStoreIntent = Intent(Intent.ACTION_VIEW,
            Uri.parse("market://details?id=com.google.android.apps.chromecast.app"))
        startActivity(playStoreIntent)
    } catch (e: ActivityNotFoundException) {
        val playStoreUrl =
            "https://play.google.com/store/apps/details?id=com.google.android.apps.chromecast.app"
        val webIntent = Intent(Intent.ACTION_VIEW, Uri.parse(playStoreUrl))
        startActivity(webIntent)
    }
}

madeby.google.com または assistant.google.com でフォーマットされた以前のディープリンク URL は非推奨となっています。

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

アプリ内のすべてのボタンと製品サイトを更新して、ユニバーサル リンクまたは googlehome://setup/ha_linking カスタム スキームを使用するようにしてください。

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