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

연기 + CO 경보

연기 + CO 경보

Nest Protect 는 주거 환경에서 연기 및 일산화탄소 (CO)를 감지하도록 설계되었으며 가정에서 발생하는 상황을 이해하는 데 도움이되는 여러 센서가 있습니다.

Nest API 는 Nest Protect의 다음 데이터에 대한 액세스를 제공합니다.

  • 연기 또는 일산화탄소 (CO) 경보 상태
  • 배터리 상태
  • 마지막 수동 테스트 상태 및 타임 스탬프
  • 온라인 상태 및 마지막 연결 정보
  • 구조 이름 및 장치 "where name"(집 내 위치)

Smoke + CO 권한

모든 Smoke + CO 경보 API 데이터 값에 대한 읽기 액세스 권한을 얻으려면 클라이언트에 대한 Smoke + CO 읽기 권한을 선택하십시오.

Smoke + CO 경보 API에 사용 가능한 쓰기 권한이 없습니다.

연기 + CO 식별자

장치

Nest 장치는 유형별로 ID 배열로 나열되며 장치 경로를 통해 장치를 고유하게 식별하는 데 사용할 수 있습니다. 따라서 "RTMTKxs..." 의 smoke + co 경보 ID는 API를 통해 devices/smoke_co_alarms/RTMTKxs... 에서 smoke + co 경보 장치 모델을로드 할 수 있음을 의미합니다.

장치가 여러 제품에 연결되면 각 개발자는 해당 장치에 대해 다른 ID를 보게됩니다. 동일한 개발자의 여러 제품을 설치 한 장치의 경우 동일한 ID가 개발자에게 표시됩니다.

이름

두 가지 이름 속성이 제공됩니다. 더 짧은 name 속성은 사용자 인터페이스 레이블에 표시되고 name_long 은 긴 형식의 텍스트에 사용됩니다.

name

이 예에서 name 은 "Nest Protect"입니다.

이름

name_long

이 예에서 name_long 은 "Basement Nest Protect"입니다.

긴 이름

어디

where_id

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

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

where_name

Smoke + CO 읽기 권한 을 선택하면 장치 객체 ( devices/smoke_co_alarms )에서 where_name 장치에 액세스 할 수 있습니다.

다른 메타 데이터

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

데이터 가치 기술
locale 이 장치에 할당 된 언어 및 국가 코드
software_version 장치에 현재 설치된 펌웨어를 나타내는 문자열
structure_id 이 구조를 고유하게 나타내는 문자열입니다. 이것은 장치가 페어링 된 구조입니다.
last_connection Nest 서비스에 마지막으로 성공적으로 연결 한 타임 스탬프
is_online 온라인 상태. 이는 last_connection 시간과 장치 별 예상되는 재 연결 창을 사용하여 Nest에 의해 결정됩니다.

Smoke + CO 기능

배터리 상태

battery_health 필드를 사용하여 배터리 상태를 봅니다.

기술
ok 배터리 잔량
replace 배터리 잔량이 부족합니다. 교체해야합니다

CO 경보

co_alarm_state 필드를 사용하여 CO 경보 상태를보십시오.

기술
ok 정상 작동
warning CO 수준 상승 감지
emergency CO 수준이 너무 높으면 사용자가 집을 나와야합니다

화재 경보기

smoke_alarm_state 필드를 사용하여 연기 경보 상태를보십시오.

기술
ok 정상 작동
warning 연기 수준 상승 감지
emergency 연기 수준이 너무 높으면 사용자가 집을 나와야합니다

수동 테스트

이 필드를 사용하여 수동 연기 또는 CO 테스트가 현재 활성화되어 있고 마지막으로 성공적인 연기 또는 CO 테스트가 수행되었는지 확인하십시오.

UI 색상 상태

일관된 교차 제품 UI를 쉽게 디자인 할 수 있도록 ui_color_state 필드를 제공했습니다.이 필드는 Nest Protect의 전체 상태를 높은 수준으로 나타냅니다. 그것은에서 파생 is_online , battery_health , co_alarm_statesmoke_alarm_state 에 표시되는 실제 색상과 지표 반영하는 집계 조건을 제공 둥지 응용 프로그램을 .

오류 메시지

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