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

구조

구조

둥지 구조는 실제 세계의 물리적 구조를 나타냅니다. 일반적으로 사용자의 집은 기기의 구성 지점 역할을하며 집 전체에 적용되는 데이터를 저장합니다.

둥지 API는 부여 된 권한의 수준에 따라 다음과 같은 구조 수준의 데이터에 대한 액세스를 제공합니다 :

  • 구조 이름 및 장치 "where name"(집 내 위치)
  • 집에있는 장치 목록
  • 에너지 이벤트 상태 ( 에너지 러시아워 )
  • 자리 비움 상태
  • 사용자 ETA
  • 보안 상태
  • 우편 번호

일부 구조 수준 기능은 별도의보다 자세한 API 가이드에서 다룹니다.

구조 권한

액세스를 위해 ... 고르다...
에서 대부분의 데이터 값 structures 객체 멀리 , ETA , 에너지 , 또는 우편 번호 권한
name 데이터 값 structures 개체 구조 읽기 / 쓰기 권한을

권한이 작동하는 방법을 참조하십시오 상호 작용 API 참조 .

구조 식별자

이름

구조 이름은 기본적으로 "Home"으로 설정되지만 사용자가 선택하는 모든 문자열이 될 수 있습니다. 당신이 선택하면 구조는 읽기 / 쓰기 권한, 당신은 구조 변경할 수 있습니다 name .

어디에

wheres 위치를 식별 (함유하는 구조의 객체 집합이다 where_idname ). 사용은 wheres 경우 이름을 사용자 정의를 만들거나 액세스 표준 곳 이름입니다.

받는 액세스 wheres 객체는 필요 카메라 , 연기 + CO 알람 , 또는 온도 조절기의 권한을.

where_id

  • 나타내는 고유 식별자 생성 둥지 name
  • where_id , 읽기 전용이며 어디에서 사용자 정의 만들 호출에 자동으로 생성되는 name

name

  • 장치의 표시 이름입니다. 우리가 제공하는 목록의 방 이름 또는 사용자 정의 이름이 될 수 있습니다.
  • 사용자 정의 만들려면 name , 포스트 전화가 새로운 정의를 작성할 수 있도록 어디 name ; where_id 호출에 반환
  • 고려 사항
    • name 편집하거나 생성 후 삭제할 수 없습니다
    • name 구조 내에서 고유해야합니다
    • 장치는 구조, 사용자 정의에 페어링되어있는 경우 name 장치와 연결된는에서 액세스 /structures/ 경로
    • 여기서 정의하여 디바이스를 이동 name 다른 구조체는, 장치를 페어링 해제하고 원하는 이름으로 기기를 재 페어링

의 이름에 대해 자세히 알아 둥지 온도 조절 장치 ,둥지 보호둥지 캠 .

기타 메타 데이터

달리 지정하지 않는 한 모든 데이터 값은 읽기 전용입니다.

데이터 값 기술
structure_id 이 구조를 고유하게 나타내는 문자열입니다. 모든 개발자는 동일한 구조에 대해 다른 ID를 볼 수 있지만 동일한 개발자의 여러 제품에는 동일한 ID가 표시됩니다.
country_code 구조의 등록 된 위치에 매핑되는 ISO 3166-1 alpha-2 국가 코드
postal_code 국가에 따라 우편 번호 또는 우편 번호
time_zone IANA 시간대 구조의 시간대에 매핑 문자열

구조 특징

연기 및 일산화탄소 경보 상태

당신이 선택하면 연기 + CO 읽기 권한을 사용하면 액세스 할 수 있습니다 smoke_alarm_stateco_alarm_state 에서 structures 객체입니다. 이 동일한 데이터 값은 장치 개체 (사용할 수있는 devices/smoke_co_alarms ).

참고 항목 CO 경보 가이드 + 연기를 이러한 상태에 대한 자세한 내용은.

많은 데이터 값이 함께 작동하여 장치가 구조에서 작동하는 방식을 결정합니다.

  • 구조의 경우 away 상태로 설정되어 away 단어 "ECO"은 사용자가 선호하는 언어로, 둥지 온도 조절기에 표시됩니다
  • 구조의 경우 away 상태로 설정되어 away , 당신은 할 수 있습니다 :
    • 세트 fan_timer_active
    • 변경 target_temperature_f 또는 target_temperature_c
  • 구조의 경우 away 상태로 설정되어 home 수행 할 수 있습니다 :
    • ETA 전화 걸기 (여행 ID 및 도착 창 설정)
  • 긴급 차단이 활성화되어, 당신은 설정할 수 없습니다 fan_timer_active
  • 응급 열이 활성화되어, 당신은 구조가 설정할 수 없습니다 away

다중 구조

사용자가 Nest 계정에 둘 이상의 구조를 연결할 수 있으므로 제품은 사용자가 사용 가능한 구조 (구조 선택기)에서 선택할 수있는 수단을 제공해야합니다.

구조 선택기

예를 들어, ETA를 설정할 때 사용자가 ETA 목적지에 대한 구조를 선택할 수 있어야합니다. 비슷한 방식으로 사용자는 서로 다른 두 집의 "거실"에 두 개의 연기 탐지기를 가질 수 있습니다. 집에 대한 자신의 개념과 구조 상관 관계를 수행해야하는 경우 승인 프로세스 중에이를 수행하는 것이 좋습니다.

방법에 대해 알아보십시오 사용자가 여러 구조의 장치를 관리 .

장치 최대 값

Nest가 구조에서 지원하는 기기 수에는 제한이 있습니다.

기기 종류 구조 당 최대
Nest 온도 조절기 20
Nest 카메라 10
Nest Protect 18

오류 메시지

API 호출 오류의 의미와이를 처리하는 방법, 무엇을보고에 대한 자세한 내용은 오류 메시지 .