深層連結

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 是 Cloud-to-Cloud 整合的專案 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 說明文件。