Google is committed to advancing racial equity for Black communities. See how.

授權概述

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