Google 正在将第三方智能家居账号关联功能迁移到 Google Home app (GHA) 中,以便完全独立地处理相关事宜,同时停用对 Google 搜索应用和 Google 助理设置的旧版依赖项。
核心后端 OAuth 2.0 基础架构、凭据和履单 Webhook 保持不变。合作伙伴需要更新应用内深层链接和网页深层链接、应用翻转许可名单(如果支持)以及面向客户的设置说明。
查看您的集成,确认是否需要进行以下更改。 如果您的集成依赖于应用内深层链接或 App Flip,则必须在 2026 年 9 月 30 日之前完成这些更新,以免应用内链接尝试失败。
使用 Google 深层链接更新应用内链接
如果您的应用或产品网站提供使用 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 措辞,例如:
- “确保已安装 Google Home 应用,然后按照将第三方应用关联到 Google Home 应用中所述的账号关联流程操作。”
参考
如需了解更多背景信息和实现详情,请参阅深层链接指南和 App Flip 指南。
如果您对此次迁移有任何疑问或需要帮助,请访问 Cloud-to-Cloud 支持页面,了解如何与 Google 联系。