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

Nest API 참조

Nest API는 실제 집이나 건물을 구조물로 모델링하고 Nest Learning Thermostats, Nest Protect, 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 ...