Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

Nest API 참조

Nest API는 Nest Learning Learning Thermostat, Nest Protect, Nest Cam을 집 안의 기기로 활용하여 실제 집이나 건물을 구조로 모델링합니다. 집에는 외출 또는 ETA 상태 또는 활성 피크타임과 같은 집 전체 정보가 포함됩니다.

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

양방향 API 참조를 사용하여 데이터 모델을 살펴보세요.

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

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

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

그러나 각 기기 기반 객체는 실제 제약 조건 아래에서 작동합니다. 예를 들어 응급 난방이 사용 설정되어 있으면 온도 조절기에서 에어컨을 실행하면 안 됩니다. Google의 API는 사용자의 기기와 집 안을 모두 보호하도록 설계되었으며, 놀랍거나 위험한 상황이 발생할 경우 특정 작업을 방지합니다.

권한 및 공유 기기 데이터

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

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

데이터 및 개인 정보 보호

가정용 제품과 관련된 데이터는 개인 정보일 수 있습니다. 홈 센서 데이터에는 사람들이 생활 속에서 어떻게 살고 있는지에 관한 정보가 포함됩니다. 데이터의 보안과 처리는 매우 중요하며 Nest에서는 이에 중점을 둡니다. Google은 사용자에게 보유하고 있는 데이터의 종류, 데이터가 사용되는 방식, 데이터 관리 권한을 사용자에게 명확히 알립니다.

개인 정보 보호에 대한 YouTube의 견해를 자세히 알아보세요.

메타데이터

메타데이터는 루트 수준 엔드포인트를 호출할 때 제공되는 추가 정보입니다.

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이 Works with Nest 제품 A와 Works with Nest 제품 B를 승인하면 제품 A의 사용자 1은 user_id 값이고 제품 B의 사용자 1은 user_id 값이 다릅니다.

세부정보
반환string
예: z.1.1.7DHps...