帳戶連結遷移指南

Google 正在進行轉換,將第三方智慧住宅帳戶連結功能完全獨立出來,並交由 Google Home app (GHA) 處理,同時淘汰對 Google 搜尋應用程式和 Google 助理設定的舊版依附元件。

核心後端 OAuth 2.0 基礎架構、憑證和履行 Webhook 保持不變。合作夥伴需要更新應用程式內和網頁深層連結、應用程式翻轉允許清單 (如支援),以及提供給消費者的設定說明。

請檢查整合項目,確認是否需要進行下列變更。 如果您的整合功能使用應用程式內深層連結或 App Flip,請務必在 2026 年 9 月 30 日前完成這些更新,以免應用程式內連結嘗試失敗。

如果應用程式或產品網站提供「連結 Google 帳戶」或「連結至 Google Home」按鈕,請更新目的地網址,直接指向 GHA

平台和整合類型 舊版目的地 新目的地 (Google Home 應用程式)
通用連結 (網頁、iOS 和 Android) https://madeby.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id https://home.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id
自訂配置 (Android 和 iOS) assistant-settings://?feature=home_automation&agent_id=agent-id googlehome://setup/ha_linking?agent_id=agent-id

更新應用程式切換許可清單

如果您的整合服務支援 App Flip,且應用程式或伺服器會強制執行許可清單安全檢查,請更新許可清單以加入 GHA

Android 應用程式驗證

如果 Android 應用程式會驗證套件名稱或簽署憑證,請將 GHA 套件名稱和 SHA-256 發布簽章加入許可清單:

  • Package name:com.google.android.apps.chromecast.app
  • SHA-256 指紋: 3D:7A:12:23:01:9A:A3:9D:9E:A0:E3:43:6A:B7:C0:89:6B:FB:4F:B6:79:F4:DE:5F:E7:C2:3F:32:6C:8F:99:4A
  • 應用程式切換要求直接來自 com.google.android.apps.chromecast.app,而非 com.google.android.googlequicksearchbox

iOS 伺服器許可清單

確認 OAuth 授權伺服器允許 Google Home 重新導向 URI:

  • 正式版: https://oauth-redirect.googleusercontent.com/a/com.google.Chromecast

更新客戶支援和設定文件

查看並更新使用者手冊、包裝內附說明、支援常見問題和線上知識庫:

  • 移除要求使用者開啟 Google 搜尋應用程式或 Google 助理設定的操作說明。
  • 採用標準化的 Google Home 用語,例如:

參考資料

如需更多背景資訊和實作詳細資料,請參閱深層連結指南和應用程式切換指南。

如對這項遷移作業有任何疑問或需要協助,請參閱雲端對雲端支援頁面,瞭解如何與 Google 聯絡。