Google은 블랙 커뮤니티를위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 방법을보십시오.
이 페이지는 Cloud Translation API를 통해 번역되었습니다.
Switch to English

Nest API 참조

Nest API는 구조의 장치로 Nest Learning 온도 조절기, Nest Protects 및 Nest Cam을 사용하여 물리적 가정 또는 건물을 구조로 모델링합니다. 이 구조에는 집 전체에 대한 정보도 포함되어 있습니다 (예 : 자리 비움 또는 ETA 상태 또는 출퇴근 시간).

구조의 모든 데이터 요소는 공유 JSON 문서의 리소스 URL ( "데이터 위치")로 처리 할 수 ​​있습니다. 각 데이터 위치는 문자열, 숫자, 부울, 부모 / 자식 개체 또는 배열을 저장할 수 있습니다.

대화식 API 참조로 데이터 모델을 탐색하십시오.

API에서 데이터 모델의 여러 레벨에있는 위치의 데이터를 동기화 할 수 있습니다. 예를 들면 다음과 같습니다.

  • 모든 장치를 포함한 전체 구조
  • 구조의 단일 장치
  • 데이터 값 그룹 (현재 및 주변 온도)
  • 단일 데이터 값 (배터리 상태)

제품은 다음과 같은 이벤트에 신중하게 응답해야합니다.

그러나 각 장치 기반 개체는 실제 제약 조건 하에서 작동합니다. 예를 들어 비상 열이 활성화 된 경우 온도 조절기가 에어컨을 가동해서는 안됩니다. 우리의 API는 우리의 장치와 사용자의 가정을 보호하고 놀랍거나 위험 할 경우 특정 행동을 방지합니다.

권한 및 공유 장치 데이터

데이터 위치를 읽거나 쓰는 기능은 권한에 의해 제어됩니다. 권한 그룹은 장치 및 구조에서 선택된 데이터 값에 대한 읽기, 쓰기 또는 읽기 / 쓰기 액세스를 제공합니다.

자세한 내용은 권한 개요를 참조하십시오.

데이터 및 개인 정보

가정용 제품과 관련된 데이터는 매우 개인적 일 수 있습니다. 홈 센서 데이터에는 사람들이 개인 공간에서 어떻게 생활하는지에 대한 정보가 포함되어 있습니다. 해당 데이터의 보안 및 처리는 매우 중요하며 Nest에 중점을 둡니다. 우리는 사용자에게 우리가 가진 데이터의 종류, 사용 방법 및 제어 할 수있는 위치를 명확하게 보여줍니다.

개인 정보 보호에 대한 당사의 견해에 대해 자세히 알아보십시오.

메타 데이터

메타 데이터는 루트 수준 끝점을 호출 할 때 제공되는 추가 정보입니다.

https://developer-api.nest.com/

access_token

사용자 권한 부여 후 제품은 액세스 토큰을 사용하여 Nest 서비스에 대한 API 호출을 수행합니다. 이 액세스 토큰은 사용자가 제품을 대신하여 전화를 걸도록 승인했음을 증명하는 역할을합니다.

세부
보고 string
예 : "c.FmDPkzyzaQe ..."

client_version

클라이언트 버전은 마지막으로 사용자가 인증 한 클라이언트 버전이며 access_token 과 연결됩니다.

클라이언트의 권한을 업데이트하면 클라이언트 버전이 증가하고 사용자에게 업데이트가 가능하다는 알림이 표시됩니다. 업데이트 된 제품을 사용하려면 먼저이 클라이언트 업데이트를 수락해야합니다.

세부
보고 number
예 : 1, 17, 42

user_id

사용자 ID를 사용하면 API 호출에서 사용자를 식별 할 수 있습니다. 이 식별자는 각 Works with Nest 제품 및 사용자 조합에 따라 다릅니다.

예를 들어, 사용자 1이 Nest 제품 A와 함께 작동하고 Nest 제품 B와 함께 작동하는 경우 제품 A는 사용자 1에 대해 하나의 user_id 값을 가지며 제품 B는 사용자 1에 대해 다른 user_id 값을 갖습니다.

세부
보고 string
예 : z.1.1.7DHps ...