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

구조

구조

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

Nest API 는 부여 된 권한 레벨에 따라 다음 구조 레벨 데이터에 대한 액세스를 제공합니다.

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

일부 구조 레벨 기능은 별도의보다 자세한 API 안내서로 제공됩니다.

구조 권한

에 액세스하려면 ... 고르다...
structures 객체에서 대부분의 데이터 값 자리 비움 , ETA , 에너지 또는 우편 번호 권한
structures 객체의 name 데이터 값 구조 읽기 / 쓰기 권한

대화식 API 참조 서 에서 권한이 작동하는 방식을 참조하십시오 .

구조 식별자

이름

구조의 이름은 기본적으로 "홈"이지만 사용자가 선택한 문자열 일 수 있습니다. 구조 읽기 / 쓰기 권한을 선택하면 구조 name 변경할 수 있습니다.

어디에

wheres 는 where 식별자 ( where_idname )를 포함하는 구조에 설정된 객체입니다. 사용은 wheres 경우 이름을 사용자 정의를 만들거나 액세스 표준 곳 이름입니다.

wheres 객체에 액세스하려면 Camera , Smoke + CO Alarm 또는 Thermostat 권한이 필요합니다.

where_id

  • name 을 나타내는 고유 한 Nest 생성 식별자
  • where_id 는 읽기 전용이며 호출시 자동으로 작성되어 사용자 정의 위치 name 을 작성합니다.

name

  • 장치의 표시 이름입니다. 우리가 제공하는 목록의 방 이름 또는 사용자 정의 이름 일 수 있습니다.
  • 사용자 정의 where name 을 작성하려면 POST를 호출하여 새 사용자 정의 where name . where_id 는 호출에서 반환됩니다
  • 고려 사항
    • 생성 후 name 을 편집하거나 삭제할 수 없습니다
    • name 은 구조 내에서 고유해야합니다
    • 장치는 구조, 사용자 정의에 페어링되어있는 경우 name 장치와 연결된는에서 액세스 /structures/ 경로
    • name 이 사용자 지정 인 장치를 다른 구조로 이동하려면 장치의 페어링을 해제 한 다음 원하는 이름으로 장치를 다시 페어링하십시오.

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

다른 메타 데이터

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

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

구조 특징

연기 및 CO 경보 상태

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

이러한 상태에 대한 자세한 내용은 Smoke + 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가 구조에서 지원하는 장치 수에는 제한이 있습니다.

기기 종류 구조 당 최대
둥지 보온 장치 20
네스트 카메라 10
둥지 보호 18

오류 메시지

API 호출 오류의 의미 및 처리 방법에 대한 정보는 오류 메시지를 참조하십시오.