Google Home技能接入指南
更新时间：2026-09-04 13:57:25
一、准备工作
| 资源 | 用途 | 说明 |
|---|---|---|
| Google云账号 | 创建Google云项目 | https://console.cloud.google.com |
| Google云账号 | 创建Google Home技能 | https://console.home.google.com |
| 自有App的Key/Secret | Google Home访问AIRTC平台的密钥 | 在开发者平台上申请的Android的App Key/App Secret，请参考查看密钥 |
| 自有App英文名 | Google Home技能名称 | 自有App英文名 |
| 自有App图标 | 账号关联时展示 | 位图，按页面要求提供 |
| 自有App登录账号 | 测试使用 | 自有App的登录账号及密码。在测试阶段需要关联Google Home测试 |
| 测试设备 | 测试使用 | 测试设备已绑定到上面的测试账号 |
二、在 Google 云控制台创建项目并配置
1. 创建 Project
(1) 注册 Google 账号，并登录 Google 云控制台。
(2) 创建新的 project，名称建议使用【自有App英文名】。
2. 配置 HomeGraph API
(1) 启用 HomeGraph API
3. 配置 Service Account
(1) 创建 Service Account, 并完成授权
(2) 创建 Service Account 密钥，浏览器自动下载密钥文件，请注意保存；在 AIRTC 开发者平台上配置技能时需要使用。
三、在 Google Home 控制台创建项目并配置
1. 创建项目
(1) 登录 Google Home 控制台
(2) 关联使用上述创建的 Google 云项目
1. 配置云到云集成
(1) 创建云到云集成，并完成配置
其中具体配置项解释如下：
| 项 | 说明 | 建议值 |
|---|---|---|
| OAuth 客户端 ID | Google Home 调用 OAuth2 接口时使用 | 填写自有App的安卓的App Key |
| 客户端密钥 | Google Home 调用 OAuth2 接口时使用 | 填写自有App的安卓的App Secret |
| 授权网址 | Google Home 获取平台 AuthCode | https://gateway.iotrtcx.com/google/ovc/authorize |
| 令牌网址 | Google Home 获取 access_token、refresh_token | https://gateway.iotrtcx.com/google/ovc/getToken |
| 云端执行网址 | Google Home 获取 access_token、refresh_token | https://gateway.iotrtcus.com/va/support/assistant |
| 范围 | 授权范围 | google_access |
| 允许 Google 通过 HTTP 基本 Auth 标头来传输客户端 ID 和客户端密钥 | - | 勾选 |
四、在AIRTC开发者平台配置技能
在完成以上配置后，还需要在AIRTC开发者平台上配置技能。
注意
添加 Google Home 技能，需要切换到海外数据中心。
1. 创建技能
请参考创建技能，在平台创建相应技能。
2. 绑定产品
请参考绑定产品，在平台上绑定产品。
注意
在绑定过程中，还需要我们技术一起配置产品技能相关指令，请提供“准备工作”中的内容给我们技术。
五、测试验证
1. 准备工作
(1) 下载 Google Home App
- Android: 需要准备一台可以下载Google应用商店Google Play的手机。
搜索 Google Home，并下载 Google Home 应用程序。
(2) 打开 Google Home App，使用上述 Google 账号登录。
(3) 通过自有App绑定设备。
2. 测试技能
(1) 在 Google Home App 上完成账号关联。
- 在装有 Google Home App 上，通过 “添加” -> “设备” -> “关联应用或服务” -> “搜索上面 Google Home 云到云集成名称”
- 在打开页面中，按提示进行自有用户账号登录，完成账号关联
- 完成后，会提示添加用户账号下可用的设备，选择需要的设备绑定到 Google Home App 中
(2) 在 Google Home App 上发现设备列表，观察是否能发现账号下的设备列表。
(3) 通过 Google Home App 控制设备，观察是否能完成对应的指令。
(4) 通过 Google Home App 或者 Google Home 音响语音控制设备，观察是否能完成对应的指令。
六、技能认证
在 Google Home 控制台继续上述云到云集成配置的过程，通过页面引导完成测试后，填写相关信息并提交认证。