20HomeAssistant 怎么接入nest温控器，小白教程

admin

接入 Nest 是 Home Assistant 中步骤最繁琐的集成之一，需要科学上网，因为 Google 要求的安全认证非常严格。

请做好心理准备，整个过程大概需要 20-30 分钟，并且 Google 会收取 5 美元 的一次性开发者费用（这是 Google 收的，不是 HA 收的）。

---

✅ 准备工作（必读）

• 账号：你需要一个 Google 账号（建议使用非 G-Suite 的个人 Gmail）。

• 外网访问：你的 Home Assistant 必须能通过 HTTPS 访问（例如配置了 SSL 证书），或者你使用的是 Nabu Casa 云服务。

• 信用卡：用于支付 Google Device Access 的 5 美元费用。

• 电脑操作：请务必在电脑浏览器上操作，不要用手机。

  
  

---

第一步：创建 Google Cloud 项目 (GCP)

我们需要先向 Google 申请一个“云项目”来获取 API 权限。

• 访问 Google Cloud Console 并登录。

• 点击左上角的项目下拉菜单，选择 “新建项目” (New Project)。

  • 项目名称：随便填，例如 HA-Nest。

  • 点击 创建 (Create)。

    
    

• 项目创建好后，确保左上角选中了你刚创建的 HA-Nest 项目。

• 启用 API：

  • 点击左侧菜单 “API 和服务” > “库” (Library)。

  • 搜索 Smart Device Management API，点击进入并 启用 (Enable)。

  • 再次搜索 Cloud Pub/Sub API，点击进入并 启用 (Enable)。

    
    
  
  

---

第二步：配置 OAuth 认证屏幕

• 在 Google Cloud Console 左侧菜单，点击 “API 和服务” > “OAuth 同意屏幕” (OAuth consent screen)。

• User Type 选择 “外部” (External)，点击 创建。

• 应用信息：

  • 应用名称：Home Assistant

  • 用户支持邮箱：选你的邮箱。

  • 开发者联系邮箱：填你的邮箱。

  • 其他留空，点击 保存并继续。

    
    

• 范围 (Scopes)：直接点 保存并继续 跳过。

• 测试用户 (Test users)：

  • 点击 添加用户 (Add Users)。

  • 一定要输入你自己的 Google 邮箱地址（就是你用来登录 Nest 的那个）。

  • 点击 保存并继续。

    
    
  
  

---

第三步：获取凭证 (Credentials)

• 点击左侧菜单 “API 和服务” > “凭证” (Credentials)。

• 点击上方 “创建凭证” (Create Credentials) > “OAuth 客户端 ID” (OAuth client ID)。

• 应用类型：选择 “Web 应用” (Web application)。

• 名称：HA Credentials。

• 已获授权的重定向 URI (Authorized redirect URIs)：

  • 点击 添加 URI。

  • 输入：https://my.home-assistant.io/redirect/oauth

  • 注意：这是官方推荐的最简单方式，避免你自己配置复杂的 URL。

    
    

• 点击 创建。

• 重要：屏幕上会弹出 客户端 ID (Client ID) 和 客户端密钥 (Client Secret)。

  • ⚠️ 请务必复制这两个字符串保存到记事本里，后面马上要用！

    
    
  
  

---

第四步：注册 Device Access Console (需付 $5)

• 访问 Google Device Access Console。

• 点击 Go to the Device Access Console。

• 勾选同意条款，支付 5 美元 费用（如果以前付过就不用了）。

• 支付完成后，点击 Create project。

• Project Name：填 HA Nest。

• OAuth client ID：填入你在 第三步 中获取的 客户端 ID (Client ID)。

• 点击 Next。

• Events：确保勾选 Enable Events，然后点击 Create project。

• 重要：创建成功后，你会看到一个 Project ID（格式通常是长长的一串字符，类似 UUID）。

  • ⚠️ 复制这个 Project ID，保存到记事本，标记为“Device Access Project ID”。

    
    
  
  

---

第五步：在 Home Assistant 中接入

回到你的 Home Assistant 界面 (2025.12.2 版本)。

• 点击左侧侧边栏的 配置 (Settings) > 设备与服务 (Devices & services)。

• 点击右下角的 添加集成 (Add Integration)。

• 搜索 Google Nest 并点击。

• 选择 Cloud (OAuth) 方式（通常是默认）。

• 接下来会让你填写这几个关键信息（请从你的记事本里复制）：

  • Cloud Project ID：这是你在 第一步 里创建的 Google Cloud 项目的 ID（不是 Device Access ID）。

    • 查找方法：在 Google Cloud Console 首页 Dashboard 的“项目信息”卡片里可以看到

      
      

  • Device Access Project ID：这是你在 第四步 结尾复制的那串 ID。

  • Client ID：第三步获取的。

  • Client Secret：第三步获取的。

    
    

• 点击 下一步 或 提交。

• Home Assistant 会弹出一个新窗口引导你去 Google 登录授权。

  • 如果是“Google 未验证此应用”的警告，点击 高级 (Advanced) > 转至...[。

  • 勾选所有权限（Nest Thermostat, Energy 等）。

  • 最后确认链接。

    
    

• 如果一切顺利，页面会跳转回 Home Assistant，并提示“成功”。

  
  

常见问题排查

• 错误：Error 400: redirect_uri_mismatch

  • 原因：你在第三步填写的“重定向 URI”和 Home Assistant 实际使用的不一致。

  • 解决：确保 Google Cloud Console 里的重定向 URI 是 https://my.home-assistant.io/redirect/oauth。

    
    

• 找不到实体？

  • 集成添加成功后，可能需要几秒钟同步。去“开发者工具” > “状态”里搜索 climate.开头的实体。

    
    

• Pub/Sub 错误

  • 通常 HA 会自动处理 Pub/Sub 订阅。如果报错，请检查你在第一步是否启用了 Cloud Pub/Sub API。

    
    
  
  

恭喜你！现在你应该能在 Home Assistant 面板里看到并控制你的 Nest 温控器了。