Notice: We're retiring Works with Nest. See the home page for more information.
Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기
이 페이지는 Cloud Translation API를 통해 번역되었습니다.
Switch to English

구조 API

사용자는 구조 당 여러 장치를 사용하여 최대 3 개의 구조를 추가 할 수 있습니다.

아래의 모든 값은 JSON 문서의 각 structures/ structure_id 아래에 있습니다.

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 경보 목록입니다. 이것은 구조에 모든 연기 + 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
값 : "집", "멀리"
접속하다 읽기 / 쓰기
가능 읽다:
서모 스탯 읽기 / 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
예 : "미국", "CA", "영국"
접속하다 읽기 전용
가능 서모 스탯 읽기 / 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는 사용자가 특정 시간에 집으로 돌아올 것으로 예상됨을 알리는 데 사용됩니다. ETA 통화 방법에 대한 정보는 Away Guide를 참조하십시오.

세부
https://developer-api.nest.com/structures/ structure_id /eta
보고 object
예 : "myTripID1024", "2014-10-31T22 : 42 : 00.000Z", "2016-12-31T23 : 59 : 59.000Z"
매개 변수
trip_id 여행을 식별하는 사용자 정의 문자열
estimated_arrival_window_begin ISO 8601 형식의 타임 스탬프
NOW 보다 커야합니다.
estimated_arrival_window_end ISO 8601 형식의 타임 스탬프
보다 커야합니다 estimated_arrival_window_begin .
접속하다 쓰기 전용
가능 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
값 : 참, 거짓
접속하다 읽기 전용
가능 에너지 읽기 / v1-v2

wwn_security_state

구조 보안 상태.

세부
https://developer-api.nest.com/structures/ structure_id /wwn_security_state
유형 string enum
값 : "ok", "deter"
접속하다 읽기 전용
가능 보안 상태 읽기 / v1

어디에

구조의 장치에 대한 위치 식별자 ( where_idname )를 포함하는 객체입니다. name 은 장치의 표시 이름입니다. 우리가 제공하는 목록의 방 이름 또는 사용자 정의 이름이 될 수 있습니다.

에 대한 자세한 내용은 wheres 의 참조 구조 설명서를 .

Nest 온도 조절기 , Nest ProtectsNest Cam의 이름에 대해 자세히 알아보십시오.

세부
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 을 나타내는 고유 한 Nest 생성 식별자입니다.

where_idname 작성 호출 중에 자동으로 작성되어 리턴됩니다.

세부
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