账号关联迁移指南

Google 正在将第三方智能家居账号关联功能迁移到 Google Home app (GHA) 中,以便完全独立地处理相关事宜,同时停用对 Google 搜索应用和 Google 助理设置的旧版依赖项。

核心后端 OAuth 2.0 基础架构、凭据和履单 Webhook 保持不变。合作伙伴需要更新应用内深层链接和网页深层链接、应用翻转许可名单(如果支持)以及面向客户的设置说明。

查看您的集成,确认是否需要进行以下更改。 如果您的集成依赖于应用内深层链接或 App Flip,则必须在 2026 年 9 月 30 日之前完成这些更新,以免应用内链接尝试失败。

如果您的应用或产品网站提供使用 Google 账号关联关联到 Google Home 按钮,请更新目标网址,以便直接定位到 GHA

平台和集成类型 旧版目的地 新目的地(Google Home 应用)
通用链接(Web、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 许可名单

如果您的集成支持 App Flip,并且您的应用或服务器强制执行许可名单安全检查,请更新您的许可名单以包含 GHA

对于 Android 应用验证

如果您的 Android 应用会验证软件包名称或签名证书,请将 GHA 软件包名称和 SHA-256 发布签名添加到许可名单中:

  • 软件包名称: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 措辞,例如:

参考

如需了解更多背景信息和实现详情,请参阅深层链接指南和 App Flip 指南。

如果您对此次迁移有任何疑问或需要帮助,请访问 Cloud-to-Cloud 支持页面,了解如何与 Google 联系。