开始使用

该 Device Access 计划允许用户使用 SDM API 访问、控制和管理 Google Nest 设备。

如需开始使用 Device Access,您需要完成以下任务:

  1. 注册该 Device Access 计划。
  2. 使用 Google 账号激活受支持的 Nest 设备。
  3. 创建 Google Cloud 云项目以启用 SDM API 并获取 OAuth 2.0 客户端 ID。
  4. 创建 Device Access 项目以接收项目 ID。

注册设备权限

在创建第一个项目之前,您必须注册 Device Access。 注册包括接受 Google APIDevice Access Sandbox 服务条款,以及为每个账号支付一次性 不可退款的费用(5 美元)。

在您接受服务条款并支付注册费之前,您将无法创建项目。这适用于所有用户,包括个人用户和希望创建商业产品的用户。

如果您尚未注册,请在 Device Access 控制台中注册:

前往 Device Access 控制台

如需了解详情,请参阅Device Access 注册

激活受支持的设备

该计划支持以下设备: Device Access

  • 所有 Google Nest 温控器
  • 所有 Google Nest 摄像头
  • 所有 Google Nest 门铃
  • Google Nest Hub Max

如需查看各个设备型号的列表,请参阅受支持的设备页面。

如需了解如何激活受支持的设备,请参阅设备手册。

设置 Google Cloud Platform

您可以通过 Google Cloud 访问 SDM API。如需启用该 API 并使用受支持的 Nest 设备授权 Google 账号,您需要一个 Google Cloud 项目。

使用下面的启用 API 并获取 OAuth 2.0 客户端 ID 按钮启用 Smart Device Management API 并获取 OAuth 2.0 客户端 ID:

  1. 如果您有想要用于 的现有 Google Cloud 项目 Device Access,请先确保您已登录该项目的管理员账号 。然后,点击该按钮后,从可用项目列表中选择现有项目。否则,请创建一个新项目。
  2. 当系统询问“您从何处调用?”时,请选择网络服务器
  3. 输入 https://www.google.com 作为授权重定向 URI 的值。如需使用 PCM 获取授权代码,您需要提供重定向 URI。
  4. 设置完成后,复制 OAuth 2.0 客户端 ID 和客户端密钥值,并将凭据 JSON 下载到本地机器
启用 API 并获取 OAuth 2.0 客户端 ID

如果您想手动设置 Google Cloud 项目,或者想验证设置并再次检索凭据,请执行以下操作:

  1. API 启用页面上启用 Smart Device Management API
  2. 凭据页面上获取 OAuth 2.0 客户端 ID。

创建设备权限项目

返回到 Device Access 控制台。

  1. 在控制台主屏幕上,选择 创建 项目
  2. 填写创建过程中的每个屏幕:
    1. 为您的项目输入名称。
    2. 输入在 设置 Google Cloud Platform期间生成的 OAuth 2.0 客户端 ID。如果您之前没有复制 OAuth 客户端 ID,可以在下载的 credentials.json 文件中找到它。
    3. 启用或停用事件。事件由 Google Cloud Pub/Sub 管理,并为已授权给您的项目的所有设备和结构提供异步更新。如果您需要事件,请依次选择 启用事件创建项目 ,然后修改 Pub/Sub 主题并提供主题 ID。如果您不确定,请选择停用 。 您随时可以稍后启用它们。
  3. 完成后,系统会为您的项目分配一个项目 ID,其形式为 UUID,例如 32c4c2bc-fe0d-461b-b51c-f3885afff2f0。请记下此 ID,您需要使用它进行所有 SDM API 调用。

此项目 ID 用于 OAuth 和 API 调用。它特定于您的 Device Access 项目,与 Google Cloud 项目 ID 无关。