开始使用

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 API 和设备访问权限沙盒的服务条款，并且每个帐号需缴纳一笔一次性且不可退款的费用（5 美元）。

您需要先接受服务条款并支付注册费，然后才能创建项目。这适用于所有用户，包括个人用户和希望创建商业产品的用户。

如果您尚未在 Device Access 控制台中注册，请先注册：

前往 Device Access 控制台

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

激活支持的设备

Device Access 计划支持以下设备：

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

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

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

设置 Google Cloud Platform

对 SDM API 的访问权限可通过 Google Cloud 提供。如需启用该 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 的值。需要使用重定向 URI 才能使用 PCM 获取授权代码。
  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 Console。

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

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

下一页
2. 授权帐号