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

授权概览

Nest API 提供了可用于构建家庭体验的信息。信息最终归用户所有,用户可以明确选择与 Works with Nest 产品共享这些信息。

授权的目的是为您的客户提供一种安全的方式来授予对其 Nest 设备数据的访问权限。

流程如下所示:

授权概述

授权前的产品网站或应用程序

在您的产品网站或应用中,您可以为客户提供一种方式,让您的产品可以访问他们的 Nest 设备数据。为此,请创建一个按钮或其他 UI 元素来启动 OAuth 流程。

在您的应用中构建用户授权时,您可以:

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

为了进一步设计指导,看到鸟巢的设计策略

框架

iFrame 呈现信息,可以嵌入到网页中,也可以作为本机应用程序中的 web 视图。基于OAuth的认证流程不支持iFrame中的嵌入

巢登录

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

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

如果用户是家庭帐户的成员,并且不拥有帐户中的所有结构,则登录后会出现连接通知。此通知列出了用户可以使用哪些结构来授权您的 Works with Nest 产品。

如果用户是账户所有者,则不会出现连接通知,并且在登录后立即显示权限页面。

欲了解更多信息,请参阅全家户口

用户授权

嵌套权限

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

欲了解更多信息,请参见权限概述

用户授权

授权后的产品站点或应用程序

在您的客户授权您的 Works with Nest 产品后,我们将发送一个授权代码,您的产品可以用该代码交换访问令牌。然后,您的 Works with Nest 产品可以发送带有 API 调用的访问令牌以访问 Nest 数据。

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

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