授權概述

Nest API 可提供實用資訊,打造住家體驗。 這些資訊最終為使用者所有,且使用者可明確選擇是否要與 Works with Nest 產品分享這類資訊。

授權的用途是讓客戶安全地存取 Nest 裝置資料。

流程看起來會像這樣:

授權總覽

授權前所購買的產品網站或應用程式

在產品網站或應用程式中,您可以為客戶提供產品 Nest 裝置資料的存取權。做法是建立按鈕或其他 UI 元素來啟動 OAuth 流程,

在應用程式中建立使用者授權時,您可以採取下列其中一種做法:

  • 使用外部瀏覽器授權應用程式
  • 使用新的網頁驗證 WebView

如需更多設計指南,請參閱 Nest 設計政策

iFrame

iFrame 會將資訊嵌入網頁或原生應用程式的 WebView 中。 OAuth 流程不支援在 iframe 中嵌入

Nest 登入

如果使用者尚未登入,我們會提示使用者登入。

連線通知 (僅限非擁有者)

如果使用者是家庭群組中的成員,且不是帳戶中的所有結構,則系統會在登入後顯示連線通知。這則通知會列出使用者能授權哪些 Works with Nest 產品結構。

如果使用者是帳戶擁有者,系統就不會顯示連線通知,並在登入後顯示權限頁面。

詳情請參閱家庭帳戶

使用者授權

Nest 權限

系統會提示使用者授予產品存取權。這個頁面會顯示您在建立用戶端時輸入的權限和說明。

詳情請參閱權限總覽

使用者授權

授權後的產品網站或應用程式

客戶授權 Works with Nest 產品後,我們會傳送授權碼,給您的產品可換取存取憑證。您的 Works with Nest 產品就可以透過 API 呼叫傳送存取權杖,藉此存取 Nest 資料。

客戶隨時可以撤銷存取權,因此 Works with Nest 產品無法進一步索取客戶裝置資料。

如要瞭解如何為使用者設定授權流程並取得存取憑證,請參閱使用 OAuth 2.0 驗證與授權