版本说明

2026 年 9 月 29 日

需要迁移 Google 托管的 Pub/Sub 主题

自 2026 年 11 月 30 日起,事件通知将不再发布到 Google 托管的 Pub/Sub 主题。如果您的集成使用 Google 托管的主题,您必须在 2026 年 11 月 30 日之前迁移到您自己的 Google Cloud 云项目中创建的自行托管的 Pub/Sub 主题。

截止日期过后,Google 托管的主题上的事件流式传输将停止,您的应用将不再接收实时设备状态更新或特征事件。如果您的项目已在您自己的 Google Cloud 项目中使用自托管主题,则无需执行任何操作。

迁移 Pub/Sub 主题配置不会使现有用户访问令牌或 OAuth 权限失效。自行托管的 Pub/Sub 主题和订阅在您自己的 Google Cloud 项目中进行管理,并受标准 Google Cloud Pub/Sub 定价(其中包括每月 10 GB 的免费层级)的约束。

如需了解创建和配置自托管 Pub/Sub 主题的步骤,请参阅订阅事件。

2025 年 1 月 23 日

用于事件的自托管 Pub/Sub 主题

Google 托管的 Pub/Sub 事件主题不再适用于新项目。今后,开发者必须在自己的 Google Cloud 项目中为事件创建 Pub/Sub 主题。如需了解详情,请参阅订阅事件。

2023 年 8 月 24 日

旧版摄像头迁移

部分旧版相机现在支持 WebRTC。如需了解详情,请参阅将设备迁移到 Google Home 应用支持文章。

2023 年 2 月 15 日

新增了对 Google Nest Doorbell(有线版)的支持

如需了解详情,请参阅 Google Nest Doorbell(有线版)指南。

2022 年 1 月 13 日

添加了设备权限 Web 应用示例

设备权限 Web 应用示例应用现已推出。按照提供的说明部署一款能够正常运行的 Web 应用来控制 Nest 摄像头、门铃和温控器。

2021 年 11 月 18 日

新增对 Nest Cam(配有泛光灯)和 Nest Cam(室内用,有线版)的支持

如需了解详情,请参阅 Nest Cam(配有泛光灯)和 Nest Cam(室内用,有线版)设备指南。

2021 年 9 月 21 日

新增对 Nest Cam(室外用或室内用,电池版)和 Nest Doorbell(电池版)的支持

如需了解详情,请参阅 Nest Cam(室外用或室内用,电池版)和 Nest Doorbell(电池版)设备指南。

Nest Doorbell(电池版)新增了特征 CameraClipPreview。此特征支持下载片段预览,即 MP4 格式的 10 帧视频文件。

活动消息串

已在 API 中为部分事件添加了对事件线程的支持。如需了解详情,请参阅可更新的通知。

类型 元素 说明
活动 CameraMotion 特征的动作事件 摄像头检测到有动作。
活动 CameraPerson 特征的人事件 摄像头检测到有人。
活动 DoorbellChime 特征的电铃事件 有人按了门铃。

“支持的设备”页面

我们发布了一个新页面,其中按型号列出了支持的设备,并根据需要详细说明了每种设备在 API 功能方面的差异。

2021 年 7 月 2 日

更新了错误文档

所有错误文档都已从“参考”标签页移至“API 指南”标签页的“错误和问题排查”部分,并且新增了授权错误页面。

授权快速参考

我们已在快速入门指南和新的“授权错误”页面中添加了一个新的授权快速参考微件,其中提供了完整授权流程的简明版本。

2021 年 1 月 20 日

资源事件载荷已更新

已向所有资源事件载荷添加新字段 resourceGroup。如需了解详情,请参阅资源事件。

未经验证的应用

我们已在授权和 Google Cloud Platform 设置页面上发布了有关未经验证的应用的信息。

2020 年 11 月 19 日

“构建具备设备权限的 Web 应用”Codelab

我们发布了一篇新的 Codelab,名为构建设备权限 Web 应用。在此 Codelab 中,您将学习Device Access 的运作方式,并构建一个处理身份验证及针对 Nest 温控器调用 SDM API 的 Web 应用。

2020 年 10 月 29 日

客户端库

我们已为 SDM API 添加 Google API 客户端库。如需查看支持的语言列表,请参阅客户端库,您可以使用这些语言为 Device Access 项目提供更好的语言集成和更高的安全性。

有关活动管理和服务账号的指南

我们添加了有关 Pub/Sub 事件管理和相关服务账号使用方面的指南:

2020 年 10 月 8 日

合作伙伴连接管理工具 (PCM) 错误参考文档

我们发布了账号关联期间遇到的错误的相关参考页面。如需了解详情,请参阅合作伙伴连接管理工具 (PCM) 错误参考。

2020 年 9 月 22 日

“设备权限”功能已发布!

Device Access 计划现已正式推出。如需详细了解如何开始使用,请参阅注册。