사용자는 추가 할 수있는 세 가지 구조의 최대 구조에 여러 장치.
값 아래 모든 각에서 찾을 수 있습니다 structures/ structure_id json으로 문서에.
structure_id
구조의 ID 번호입니다. 이 데이터 위치를 호출하면이 구조의 데이터 값에 액세스 할 수 있습니다.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /structure_id | |
| 보고 | string예 : "VqFabWH21nw ..." |
| 접속하다 | 읽기 전용 |
| 가능 | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기 / 쓰기 / v1-v6 Smoke + CO 읽기 / v1-v5 자리 비움 읽기 / v1-v2 자리 비움 읽기 / 쓰기 / v1-v2 ETA 쓰기 / v1-v2 우편 번호 읽기 / v2 카메라 읽기 / v1-v3 카메라 읽기 + 이미지 / v1-v4 카메라 읽기 / 쓰기 / v1-v3 카메라 읽기 / 쓰기 + 이미지 / v1-v4 에너지 읽기 / v2 |
온도 조절기
고유 한 장치 식별자별로 구조의 온도 조절기 목록입니다. 이것은 구조의 모든 온도 조절기를 포함하는 JSON 객체의 배열입니다.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /thermostats | |
| 보고 | array예 : [ "peyiJNo0IldT2YlIVtYaGQ",... ] |
| 접속하다 | 읽기 전용 |
| 가능 | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기 / 쓰기 / v1-v6 Smoke + CO 읽기 / v1-v5 자리 비움 읽기 / v1-v2 자리 비움 읽기 / 쓰기 / v1-v2 ETA 쓰기 / v1-v2 카메라 읽기 / v2-v3 카메라 읽기 + 이미지 / v2-v4 카메라 읽기 / 쓰기 / v2-v3 카메라 읽기 / 쓰기 + 이미지 / v2-v4 |
smoke_co_alarms
구조 내 연기 + 일산화탄소 경보 목록 (고유 장치 식별자 별) 이것은 구조의 모든 연기 + CO 경보를 포함하는 JSON 객체의 배열입니다.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /smoke_co_alarms | |
| 보고 | array예 : [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ] |
| 접속하다 | 읽기 전용 |
| 가능 | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기 / 쓰기 / v1-v6 Smoke + CO 읽기 / v1-v5 자리 비움 읽기 / v1-v2 자리 비움 읽기 / 쓰기 / v1-v2 ETA 쓰기 / v1-v2 카메라 읽기 / v2-v3 카메라 읽기 + 이미지 / v2-v4 카메라 읽기 / 쓰기 / v2-v3 카메라 읽기 / 쓰기 + 이미지 / v2-v4 |
카메라
고유 장치 식별자 별 구조의 카메라 목록입니다. 이것은 구조의 모든 카메라를 포함하는 JSON 객체의 배열입니다.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /cameras | |
| 보고 | array예 : [ "awJo6rH...",... ] |
| 접속하다 | 읽기 전용 |
| 가능 | 온도 조절기 읽기 / v4-v6 온도 조절기 읽기 / 쓰기 / v4-v6 Smoke + CO 읽기 / v4-v5 멀리 읽기 / v2 자리 비움 읽기 / 쓰기 / v2 ETA 쓰기 / v2 카메라 읽기 / v1-v3 카메라 읽기 + 이미지 / v1-v4 카메라 읽기 / 쓰기 / v1-v3 카메라 읽기 / 쓰기 + 이미지 / v1-v4 |
떨어져
구조물의 점유 상태를 나타냅니다.
: 구조는 존재와 관련된 두 가지 상태가 home 또는 away . 아무런 움직임이 집에서 감지되지 않은 경우, 구조가 변경됩니다 home 에 away .
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /away | |
| 보고 | string값 : "home", "away" |
| 접속하다 | 읽기 / 쓰기 |
| 가능 | 읽다: 온도 조절기 읽기 / v1-v6 온도 조절기 읽기 / 쓰기 / v1-v6 Smoke + CO 읽기 / v1-v5 자리 비움 읽기 / v1-v2 자리 비움 읽기 / 쓰기 / v1-v2 ETA 쓰기 / v1-v2 쓰다: 자리 비움 읽기 / 쓰기 / v1-v2 |
이름
구조의 사용자 정의 표시 이름입니다.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /name | |
| 보고 | string예 : "내 집", "비치 하우스", "마운틴 하우스" |
| 접속하다 | 읽기 / 쓰기 |
| 가능 | 읽다: 온도 조절기 읽기 / v1-v6 온도 조절기 읽기 / 쓰기 / v1-v6 Smoke + CO 읽기 / v1-v5 자리 비움 읽기 / v1-v2 자리 비움 읽기 / 쓰기 / v1-v2 ETA 쓰기 / v1-v2 우편 번호 읽기 / v2 카메라 읽기 / v1-v3 카메라 읽기 + 이미지 / v1-v4 카메라 읽기 / 쓰기 / v1-v3 카메라 읽기 / 쓰기 + 이미지 / v1-v4 에너지 읽기 / v2 구조 읽기 / 쓰기 / v1 쓰다: 구조 읽기 / 쓰기 / v1 |
국가 코드
국가 코드에 ISO 3166 알파 - 2 형식입니다.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /country_code | |
| 보고 | string예 : "US", "CA", "UK" |
| 접속하다 | 읽기 전용 |
| 가능 | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기 / 쓰기 / v1-v6 Smoke + CO 읽기 / v1-v5 자리 비움 읽기 / v1-v2 자리 비움 읽기 / 쓰기 / v1-v2 ETA 쓰기 / v1-v2 |
우편 번호
국가에 따라 우편 번호입니다.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /postal_code | |
| 보고 | string예 : "94304", "94304-1027", "EC1A 1BB" |
| 접속하다 | 읽기 전용 |
| 가능 | 우편 번호 읽기 / v1-v2 |
peak_period_start_time
의 시간이 시작 에너지 러시아워 에, 이벤트를 ISO 8601 형식을.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /peak_period_start_time | |
| 보고 | string예 : "2016-12-31T23 : 59 : 59.000Z" |
| 접속하다 | 읽기 전용 |
| 가능 | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기 / 쓰기 / v1-v6 에너지 읽기 / v1-v2 |
peak_period_end_time
의 시간 종료 에너지 러시아워 에, 이벤트를 ISO 8601 형식을.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /peak_period_end_time | |
| 보고 | string예 : "2016-12-31T23 : 59 : 59.000Z" |
| 접속하다 | 읽기 전용 |
| 가능 | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기 / 쓰기 / v1-v6 에너지 읽기 / v1-v2 |
시간대
의 구조에서 시간대, IANA 시간대 형식입니다.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /time_zone | |
| 보고 | string예 : "America / Los_Angeles" |
| 접속하다 | 읽기 전용 |
| 가능 | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기 / 쓰기 / v1-v6 Smoke + CO 읽기 / v1-v5 자리 비움 읽기 / v1-v2 자리 비움 읽기 / 쓰기 / v2 ETA 쓰기 / v1-v2 |
에타
ETA (예상 도착 시간)는 구조에 설정할 수있는 객체입니다. 사용자가 특정 시간에 집으로 돌아갈 것으로 예상된다는 것을 Nest에 알리는 데 사용됩니다. 도착 예정 시간 통화를하는 방법에 대한 자세한 내용은 참조 안내서를 멀리 .
| 세부 | |||||||
|---|---|---|---|---|---|---|---|
https://developer-api.nest.com/structures/ structure_id /eta | |||||||
| 보고 | object예 : "myTripID1024", "2014-10-31T22 : 42 : 00.000Z", "2016-12-31T23 : 59 : 59.000Z" | ||||||
| 매개 변수 |
| ||||||
| 접속하다 | 쓰기 전용 | ||||||
| 가능 | ETA 쓰기 / v1-v2 | ||||||
eta_begin
도착의 초기 예상 시간의 타임 스탬프 ISO 8601 형식입니다. 작업 또는 이벤트를 트리거하는 데 사용됩니다.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /eta_begin | |
| 보고 | string예 : "2016-12-31T23 : 59 : 59.000Z" |
| 접속하다 | 읽기 전용 |
| 가능 | ETA 읽기 / v1 |
rhr_enrollment
러시아워는 보상 등록 상태를.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /rhr_enrollment | |
| 보고 | boolean값 : true, false |
| 접속하다 | 읽기 전용 |
| 가능 | 에너지 읽기 / v1-v2 |
wwn_security_state
구조 보안 상태.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /wwn_security_state | |
| 유형 | string enum값 : "ok", "deter" |
| 접속하다 | 읽기 전용 |
| 가능 | 보안 상태 읽기 / v1 |
어디에
여기서, 포함 된 객체 식별자 ( where_id 및 name 구조의 장치). name 상기 장치의 디스플레이 이름. 우리가 제공하는 목록의 방 이름이거나 사용자 지정 이름 일 수 있습니다.
에 대한 자세한 내용은 wheres 의 참조 구조 설명서를 .
더의 이름 위치에 대해 알아 둥지 온도 조절 장치는 ,둥지를 보호 하고 둥지 캠 .
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /wheres | |
| 보고 | object |
| 접속하다 | 읽기 전용 |
| 가능 | 읽다: 온도 조절기 읽기 / v3-v6 온도 조절기 읽기 / 쓰기 / v3-v6 Smoke + CO 읽기 / v3-v5 카메라 읽기 / v1-v3 카메라 읽기 + 이미지 / v1-v4 카메라 읽기 / 쓰기 / v1-v3 카메라 읽기 / 쓰기 + 이미지 / v1-v4 |
where_id
나타내는 고유 식별자 생성 둥지 name .
where_id 자동으로 생성하고 생성하기 위해 통화 중에 반환되는 name .
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /where_id | |
| 보고 | string예 : "Fqp6wJI ..." |
| 접속하다 | 읽기 전용 |
| 가능 | 읽다: 온도 조절기 읽기 / v3-v6 온도 조절기 읽기 / 쓰기 / v3-v6 Smoke + CO 읽기 / v3-v5 카메라 읽기 / v1-v3 카메라 읽기 + 이미지 / v1-v4 카메라 읽기 / 쓰기 / v1-v3 카메라 읽기 / 쓰기 + 이미지 / v1-v4 |
이름
장치의 표시 이름입니다.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /name | |
| 보고 | string예 : "침실" |
| 접속하다 | 읽기 / 쓰기 |
| 가능 | 읽다: 온도 조절기 읽기 / v3-v6 온도 조절기 읽기 / 쓰기 / v3-v6 Smoke + CO 읽기 / v3-v5 카메라 읽기 / v1-v3 카메라 읽기 + 이미지 / v1-v4 카메라 읽기 / 쓰기 / v1-v3 카메라 읽기 / 쓰기 + 이미지 / v1-v4 |
co_alarm_state
CO 경보 상태.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /co_alarm_state | |
| 보고 | string enum값 : "ok", "warning", "emergency" |
| 접속하다 | 읽기 전용 |
| 가능 | Smoke + CO 읽기 / v5 |
smoke_alarm_state
화재 경보 상태.
| 세부 | |
|---|---|
https://developer-api.nest.com/structures/ structure_id /smoke_alarm_state | |
| 보고 | string enum값 : "ok", "warning", "emergency" |
| 접속하다 | 읽기 전용 |
| 가능 | Smoke + CO 읽기 / v5 |