Google 致力于为黑人社区推动种族平等。查看具体举措

授权概览

Nest API 可为您提供可用于打造家居体验的信息。 信息最终归用户所有,用户可以明确选择与 Works with Nest 产品共享这些信息。

授权的目的是为您的客户提供安全的方式,使其能够访问 Nest 设备数据。

流程如下所示:

授权概览

授权前的产品网站或应用

在您的产品网站或应用中,您可以为客户提供一种方式,使其能够授予您的产品对其 Nest 设备数据的访问权限。为此,请创建按钮或其他界面元素来启动 OAuth 流程。

在应用中构建用户授权时,您可以采用以下任一方法:

  • 使用外部浏览器授权应用
  • 使用新页面对 webapp 进行身份验证

如需进一步的设计指南,请参阅 Nest 设计政策

iframe

iframe 可显示嵌入在网页中或作为原生应用的网页视图的信息。 OAuth 流程不支持嵌入 iframe

Nest 登录

如果用户尚未登录,我们会提示用户登录。

连接通知(仅限非所有者)

如果用户是家庭帐号的成员,并且不是该帐号中的所有结构,则系统会在登录后显示连接通知。此通知列出了用户可以授权您的 Works with Nest 产品所采用的结构。

如果用户是帐号所有者,则系统不会显示连接通知,并且登录后立即显示权限页面。

如需了解详情,请参阅家人群组帐号

用户授权

Nest 权限

我们会提示用户授予对您的产品的访问权限。此页面显示您在创建客户端时输入的权限和说明。

如需了解详情,请参阅权限概览

用户授权

授权后的产品网站或应用

在您的客户授权您的 Works with Nest 产品后,我们会发送一个授权代码,以供您的产品换取访问令牌。然后,您的 Works with Nest 产品可以通过发送 API 调用来发送访问令牌,以访问 Nest 数据。

您的客户可以随时撤消访问权限,这将阻止您的 Works with Nest 产品进一步请求客户的设备数据。

如需了解如何为用户设置授权流程并获取访问令牌,请参阅使用 OAuth 2.0 进行身份验证和授权