深層連結

Google Home app (GHA) 是使用者將智慧型裝置連結至 Google Assistant，並指派給 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，可在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 格式設定的舊版深層連結網址已淘汰：

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

更新所有應用程式內按鈕和產品網站，改用通用連結或 googlehome://setup/ha_linking 自訂配置。

如要進一步瞭解如何從應用程式內觸發深層連結，請參閱相關的 Android 說明文件和 iOS 說明文件。