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 경보 상태

당신이 선택하면 연기 + 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
네스트 카메라 10
네스트 프로텍트 18

오류 메시지

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