Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

結構體

結構體

巢狀結構代表現實世界中的物理結構。通常是用戶的家,它們充當設備的組織點,並將存儲適用於整個家的數據。

Nest API提供對以下結構級數據的訪問,具體取決於所授予的權限級別:

  • 結構名稱和設備“位置名稱”(家庭中的位置)
  • 家庭設備列表
  • 能源事件狀態( 能源高峰時間
  • 離開狀態
  • 用戶預計到達時間
  • 安全狀態
  • 郵遞區號

單獨的,更詳細的API指南涵蓋了一些結構級功能:

結構權限

訪問... 選擇...
structures像中的大多數數據值 離開ETA能源郵政編碼權限
structures像中的name數據值 結構讀/寫權限

請參閱《 交互式API參考》中的權限工作原理。

結構標識符

名稱

結構的名稱默認為“ Home”,但可以是用戶選擇的任何字符串。選擇結構讀/寫權限時,可以更改結構name

哪裡

wheres是在結構上設置的對象,其中包含where標識符( where_idname )。使用wheres創建自定義的where名稱,或訪問標準的where名稱。

要訪問wheres對象,需要具有CameraSmoke + CO AlarmThermostat權限。

where_id

  • 由Nest生成的唯一標識符,代表name
  • where_id是只讀的,並且會在調用中自動創建以創建自定義where name

name

  • 設備的顯示名稱;可以是我們提供的列表中的任何房間名稱,也可以是自定義名稱
  • 要創建一個自定義的where name ,請進行POST調用以編寫一個新的自定義的where namewhere_id中返回where_id
  • 注意事項
    • name創建後無法編輯或刪除
    • name在結構中必須唯一
    • 如果設備與結構配對,則可以從/structures/路徑訪問與設備關聯的name的自定義位置
    • 要將具有自定義name的設備移動到其他結構,請取消配對該設備,然後將其與所需名稱重新配對

詳細了解Nest ThermostatsNest ProtectsNest Cams的名稱

其他元數據

除非另有說明,否則所有數據值都是只讀的。

資料值描述
structure_id 一個唯一表示此結構的字符串。每個開發人員對於同一結構將看到不同的ID,但是同一開發人員的多個產品將看到相同的ID
country_code 映射到結構的註冊位置的ISO 3166-1 alpha-2國家/地區代碼
postal_code 郵遞區號,取決於國家
time_zone 映射到結構時區的IANA時區字符串

結構特點

煙霧和一氧化碳報警狀態

當選擇Smoke + CO讀取權限時 ,可以在structures co_alarm_state中訪問smoke_alarm_stateco_alarm_state 。這些相同的數據值在設備對象( devices/smoke_co_alarms )中也可用。

有關這些狀態的更多信息,請參見Smoke + CO警報指南

許多數據值一起確定設備在結構中的行為。

  • 當結構away狀態設置為away時,Nest Thermostat上會以用戶首選的語言顯示“ ECO”一詞
  • 將結構away狀態設置為away ,您可以:
    • 設置fan_timer_active
    • 更改target_temperature_ftarget_temperature_c
  • 當結構away狀態設置為home ,您可以:
    • 撥打ETA電話(設置行程ID和到達窗口)
  • 緊急關閉處於活動狀態時,無法設置fan_timer_active
  • 啟用緊急加熱後 ,您將無法將結構設置為away

多種結構

用戶的Nest帳戶可能附加了多個結構,因此您的產品應為用戶提供一種從可用結構中進行選擇的方法(結構選擇器)。

結構選擇器

例如,設置ETA時,用戶能夠為ETA目的地選擇結構很重要。以類似的方式,用戶可以在兩個不同房屋的“客廳”中具有兩個煙霧探測器。如果您需要使用自己的房屋概念進行結構關聯,建議您在授權過程中進行。

了解用戶如何以多種結構管理設備

設備最大值

一個結構中Nest支持的設備數量是有限的。

設備類型每個結構最大
巢式恆溫器 20
巢式相機 10
巢穴保護 18

錯誤訊息

有關什麼是API調用錯誤的含義以及如何處理錯誤的信息 ,請參見錯誤消息