Google致力於提高黑人社區的種族平等。 怎麼看。
本頁面由 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調用錯誤的含義以及如何處理錯誤的信息 ,請參見錯誤消息