사용자는 구조당 여러 대의 기기로 최대 3개의 구조를 추가할 수 있습니다.
아래의 모든 값은 JSON 문서의 각 structures/structure_id
아래에 있습니다.
집_ID
집의 ID 번호입니다. 이 데이터 위치를 호출할 때 이 구조의 데이터 값에 액세스할 수 있습니다.
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/structure_id |
|
반환 | string 예: "VqFabWH21nw..." |
액세스 | 읽기 전용 |
제공 지역: | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기/쓰기 / v1-v6 스모크+CO 읽기 / v1-v5 ETA 읽기/v1-v2 카메라 읽기/v1 v2 + v1 읽기 v1 + v1 읽기 v1 + v1 읽기 / v1 읽기 v1 + v1 읽기 / v1-v1 v1 읽기 v1 |
온도 조절기
고유한 기기 식별자별 구조 내 온도 조절기 목록입니다. 이는 구조의 모든 온도 조절기를 포함하는 JSON 객체의 배열입니다.
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/thermostats |
|
반환 | array 예: [ "peyiJNo0IldT2YlIVtYaGQ",... ] |
액세스 | 읽기 전용 |
제공 지역: | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기/쓰기 / v1-v6 스모크+CO 읽기 / v1-v5 외장 읽기 / v1-v2 카메라 읽기 / 쓰기 / v1-v2 카메라 읽기 / v1-v2 카메라 읽기 / v2 v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2 |
연기_코_알람
고유 기기 식별자별 구조 내 연기 + CO 경보 목록 이는 구조의 모든 스모크+CO 경보를 포함하는 JSON 객체의 배열입니다.
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/smoke_co_alarms |
|
반환 | array 예: [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ] |
액세스 | 읽기 전용 |
제공 지역: | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기/쓰기 / v1-v6 스모크+CO 읽기 / v1-v5 외장 읽기 / v1-v2 카메라 읽기/쓰기 / v1-v2 카메라 읽기 / v1-v2 카메라 읽기 / v2-v4 카메라 읽기/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2/v2 |
카메라
구조의 기기 목록이며 고유 기기 식별자가 있습니다. 구조에는 모든 카메라가 포함된 JSON 객체의 배열입니다.
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/cameras |
|
반환 | array 예: [ "awJo6rH...",... ] |
액세스 | 읽기 전용 |
제공 지역: | 온도 조절기 읽기 / v4-v6 온도 조절기 읽기/쓰기 / v4-v6 스모크+CO 읽기/v4-v5 외장 읽기/v2 카메라 읽기/v1-v3 카메라 읽기 + 이미지 / v1-v4 카메라 읽기/v1-v4 카메라 읽기/v1-v4 카메라 읽기/v1-v4 |
거리
집의 점유 상태를 나타냅니다.
구조에는 접속 상태와 관련된 두 가지 상태, 즉 home
또는 away
가 있습니다. 집에서 움직임이 감지되지 않으면 구조는 home
에서 away
으로 변경됩니다.
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/away |
|
반환 | string 값: "home", "away" |
액세스 | 읽기/쓰기 |
제공 지역: | 읽기: 온도 조절기 읽기 / v1-v6 온도 조절기 읽기/쓰기 / v1-v5 외출 읽기 / v1-v2 외출 읽기/쓰기 / v1-v2 ET2 쓰기 /v1/v1 |
name
구조의 사용자 정의 표시 이름입니다.
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/name |
|
반환 | string 예: "내 집 |
액세스 | 읽기/쓰기 |
제공 지역: | 읽기: 읽기 v1/읽기/v1/읽기/v1/ 읽기/v1/ 읽기/v1/ 1/ |
국가_코드
ISO 3166 alpha-2 형식의 국가 코드입니다.
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/country_code |
|
반환 | string 예: |
액세스 | 읽기 전용 |
제공 지역: | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기/쓰기 / v1-v6 스모크+CO 읽기 / v1-v5 외장 읽기 / v1-v2 외장 읽기/쓰기 / v1-v2 ETA 쓰기/v1-v2 |
우편번호
우편번호입니다. 국가에 따라 다릅니다.
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/postal_code |
|
반환 | string 예: "94304", |
액세스 | 읽기 전용 |
제공 지역: | 우편번호 읽기 / v1-v2 |
피크_기간_시작_시간
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 |
피크_기간_종료_시간
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 |
time_zone[시간대]
IANA 시간대 형식의 구조 시간대
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/time_zone |
|
반환 | string 예: "America/Los_Angeles" |
액세스 | 읽기 전용 |
제공 지역: | 온도 조절기 읽기 / v1-v6 온도 조절기 읽기/쓰기 / v1-v6 스모크+CO 읽기 / v1-v5 외장 읽기 / v1-v2 외출 읽기/쓰기 / v2 ETA 쓰기/v1-v2 |
확장 텍스트 광고
ETA (예상 도착 시간)는 구조에 설정할 수 있는 객체입니다. 특정 시간에 사용자가 집에 돌아올 것을 예상하는 것을 Nest에 알리는 데 사용됩니다. 도착예정시간 확인 방법에 대한 자세한 내용은 외출 가이드를 참조하세요.
세부정보 | |||||||
---|---|---|---|---|---|---|---|
https://developer-api.nest.com/structures/structure_id/eta |
|||||||
반환 | object 예: |
||||||
매개변수 |
|
||||||
액세스 | 쓰기 전용 | ||||||
제공 지역: | 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 값: "확인", "deter" |
액세스 | 읽기 전용 |
제공 지역: | 보안 상태 읽기 / v1 |
장소
구조 내 기기의 식별자(where_id
및 name
)가 포함된 객체 name
은 기기의 표시 이름입니다. Google에서 제공하는 목록의 회의실 이름 또는
맞춤 이름을 사용할 수 있습니다.
wheres
에 대한 자세한 내용은 구조 가이드를 참조하세요.
Nest 온도 조절기, Nest Protect, Nest Cam의 이름을 자세히 알아보세요.
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/wheres |
|
반환 | object |
액세스 | 읽기 전용 |
제공 지역: | 읽기: 온도 조절기 읽기/v3-v6 온도 조절기 읽기/쓰기/v3-v6 연기+CO 읽기/v3-v5 카메라 읽기/v1-v3 카메라 읽기 + 이미지/v1-v4 카메라 읽기/쓰기/v1-v1/v1-v1 |
where_id[ID_ID]
name
를 나타내는 고유한 Nest 생성 식별자입니다.
where_id
는 name
를 만들기 위한 호출 중에 자동으로 생성되고 반환됩니다.
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/wheres/where_id/where_id |
|
반환 | string 예: "Fqp6wJI..." |
액세스 | 읽기 전용 |
제공 지역: | 읽기: 온도 조절기 읽기/v3-v6 온도 조절기 읽기/쓰기/v3-v6 스모크+CO 읽기/v3-v5 카메라 읽기/v1-v3 카메라 읽기 + 이미지/v1-v4 카메라 읽기/쓰기/v1-v3 카메라 읽기/쓰기 + 이미지 / v1 |
name
기기의 표시 이름입니다.
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/wheres/where_id/name |
|
반환 | string 예: "침실" |
액세스 | 읽기/쓰기 |
제공 지역: | 읽기: 온도 조절기 읽기/v3-v6 온도 조절기 읽기/쓰기/v3-v6 연기+CO 읽기/v3-v5 카메라 읽기/v1-v3 카메라 읽기 + 이미지/v1-v4 카메라 읽기/쓰기 + v1-v4 / v1-v4 |
co_alarm_state
일산화탄소 경보기 상태
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/co_alarm_state |
|
반환 | string enum 값: "확인", "경고", 앞으로 |
액세스 | 읽기 전용 |
제공 지역: | Smoke+CO 읽기 / v5 |
연기_알람_상태
연기 경보 상태
세부정보 | |
---|---|
https://developer-api.nest.com/structures/structure_id/smoke_alarm_state |
|
반환 | string enum 값: "확인", "경고", 앞으로 |
액세스 | 읽기 전용 |
제공 지역: | Smoke+CO 읽기 / v5 |