Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

구조 API

사용자는 구조당 여러 대의 기기로 최대 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
예:
매개변수
trip_id이동을 식별하는 사용자 정의 문자열
estimated_arrival_window_begin ISO 8601 형식의 타임스탬프입니다.
NOW보다 커야 합니다.
estimated_arrival_window_endISO 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
값: 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