（2860期）Nest SDM – 官方 API 掌控全屋 Nest 生态

官方 API 掌控全屋 Nest 生态 通过 Google SDM API 官方接口控制 Nest 恒温器、门铃及摄像头，支持实时监控与自动化事件推送，需 $5 设备接入费与 GCP 项目配置 使用说明 核心功能 nest-sdm 是一套基于 Google Smart Device Management (SDM) API 的命令行工具集，实现对 Google Nest 生态设备的完整控制与监控。该技能支持三类核心设备：恒温器（Thermostat）、可视门铃（Doorbell）及智能显示屏/摄像头（Display），覆盖温度调节、模式切换、实时视频流、事件检测等全功能场景。 显著优势 官方 API 背书：直接对接 Google SDM 官方 REST API，非逆向工程或私有协议，稳定性与长期兼容性有保障 功能覆盖全面：不仅支持基础温控（制冷/制热/节能模式/风扇定时），还提供 WebRTC 实时视频流、Pub/Sub 事件推送、Telegram 告警集成等进阶能力 实时事件架构：通过 GCP Pub/Sub 实现真正的异步事件监听（doorbell 按键、人员检测、运动感知、HVAC 状态变化），区别于传统的轮询方案 细粒度权限控制：OAuth 2.0 授权流程，设备所有者显式授权，支持 refresh token 长期凭证（测试模式 7 天，生产模式无过期） 潜在局限与风险 准入门槛较高：需支付 $5 一次性 Device Access Console 注册费，配置 GCP 项目、OAuth 客户端、启用 SDM API，对普通用户技术门槛显著 速率限制严格：每设备 10 次查询/分钟、10 次命令/分钟，高频自动化场景受限 温度单位陷阱：API 内部强制使用摄氏度，虽 CLI 提供华氏度转换，但自定义开发时易出错 Token 有效期：GCP 应用处于"测试"模式时 refresh token 7 天过期，需手动重新授权或发布应用 WebRTC 复杂性：摄像头流仅支持 WebRTC（无 RTSP），需完整的 SDP offer/answer 信令交换，难以直接接入传统 NVR 系统 适用人群 智能家居极客与自动化爱好者，熟悉 GCP 与 OAuth 配置 需要将 Nest 设备集成至自研 Home Assistant/Node-RED 体系的技术用户 对实时告警（门铃、入侵检测）有强需求，且愿意承担 GCP 运维成本的用户 企业/物业场景下的集中化设备管理（需评估速率限制影响） 常规风险提示 认证安全：凭证文件 .nest-sdm-tokens.json 与 .nest-pubsub-tokens.json 包含 clientsecret 与 refreshtoken，必须设置 600 权限且避免版本控制泄露。网络边界：Pub/Sub 监听需暴露 GCP 项目网络配置，误配置可能导致事件流暴露。授权范围：SDM 服务 OAuth scope 权限较宽，泄露后攻击者可远程控制温控与查看摄像头流，建议启用 GCP 的 OAuth 品牌验证与受限访问。数据留存：事件日志默认写入本地 JSONL 文件，长期运行需关注磁盘空间与日志轮转。 原始说明 Control Nest thermostat, doorbell, and cameras via the Google Smart Device Management (SDM) API.