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

카메라 API

Nest API는 모든 Nest Cam ™ 모델에서 작동합니다.

사용자는 여러 둥지 캠을 추가 할 수 있습니다 devices/cameras 받는 사람, 그룹까지 구조 당 최대 . 이 데이터 위치를 호출하면 Nest Cam 데이터 (구조 내 기기의 데이터 값)에 액세스 할 수 있습니다.

아래의 모든 값은 각각 아래 발견 devices/cameras/ device_id JSON 문서이다.

장치 아이디

Nest Cam 고유 식별자입니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /device_id
보고 string
예 : "awJo6rH ..."
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

소프트웨어 버전

소프트웨어 버전.

세부
https://developer-api.nest.com/devices/cameras/ device_id /software_version
보고 string
예 : "4.0"
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

structure_id

구조 고유 식별자.

세부
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
보고 string
예 : "VqFabWH21nw ..."
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

where_id

나타내는 고유 식별자 생성 둥지 name , 디바이스의 디스플레이 이름.

더의 이름 위치에 대해 알아 둥지 온도 조절 장치는 ,둥지를 보호 하고 둥지 캠 .

세부
https://developer-api.nest.com/devices/cameras/ device_id /where_id
보고 string
예 : "d6reb_OZTM ..."
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

where_name

장치의 표시 이름입니다. 둥지 캠과 관련 where_id . 우리가 제공하는 목록의 방 이름이거나 사용자 지정 이름 일 수 있습니다. 더의 이름 위치에 대해 알아 둥지 온도 조절 장치는 ,둥지를 보호 하고 둥지 캠 .

세부
https://developer-api.nest.com/devices/cameras/ device_id /where_name
보고 string
예 : "복도"
접속하다 읽기 전용
가능 카메라 읽기 / v3
카메라 읽기 + 이미지 / v4
카메라 읽기 / 쓰기 / v3
카메라 읽기 / 쓰기 + 이미지 / v4

이름

장치의 표시 이름; 우리가 제공하는 목록의 방 이름이거나 사용자 정의 이름 일 수 있습니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /name
보고 string
예 : "복도"
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

name_long

장치의 긴 표시 이름. 사용자가 만든 사용자 지정 (라벨)를 포함, 또는를 통해 wheres .

세부
https://developer-api.nest.com/devices/cameras/ device_id /name_long
보고 string
예 : "복도 Nest Cam (위층)"
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

is_online

Nest 서비스와의 기기 연결 상태입니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /is_online
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

is_streaming

카메라 상태 (켜짐 및 활성 스트리밍 비디오 또는 꺼짐). 참조 카메라가 홈 작동 방법 / 어웨이 지원 자세한 내용은.

세부
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
보고 boolean
값 : true, false
접속하다 읽기 / 쓰기
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

is_audio_input_enabled

카메라 마이크 상태 (켜짐 및 청취 또는 꺼짐). 에 대해 자세히 알아 둥지 캠 오디오 설정 .

세부
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

last_is_online_change

에서 온라인 상태로 마지막 변경을 식별하는 타임 스탬프 ISO 8601 형식입니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change
보고 string
예 : "2016-12-29T18 : 42 : 00.000Z"
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

is_video_history_enabled

둥지 인식 구독 상태 (가입 활성 여부).

세부
https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

web_url

웹 URL에서 라이브 비디오 스트림에 (딥 링크) home.nest.com .

세부
https://developer-api.nest.com/devices/cameras/ device_id /web_url
보고 string
예 : " https://home.nest.com/cameras/ device_id ?auth= camera_token "
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

app_url

Nest 앱의 실시간 동영상 스트림에 대한 앱 URL (딥 링크)입니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /app_url
보고 string
예 : " nestmobile://cameras/ device_id ?auth= camera_token "
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

is_public_share_enabled

사용자가 선택할 수 있습니다 자신의 비디오를 공유 하고 모든 사용자가 볼 수 있도록. 공공 공유가 활성화되면, 당신은 읽을 수 public_share_url .

세부
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 카메라 읽기 + 이미지 / v3-v4
카메라 읽기 / 쓰기 + 이미지 / v3-v4

activity_zones

정의 된 모든 활동 영역의 배열을 반환합니다.

활동 영역은 비디오 스트림의 사용자 정의 영역 내에서 모션 이벤트를 모니터링하는 데 사용됩니다. 필요 둥지는 인식 .

세부
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
보고 array
예 : [ {"name" : " string1 ", "id" : " string2 "},... ]

string1 영역 이름입니다 어느 사용자 정의 영역을 만들 때 생성 자동 또는.
string2 활동 영역이 생성 될 때 둥지에 의해 할당 된 식별자입니다.
접속하다 읽기 전용
가능 카메라 읽기 + 이미지 / v3-v4
카메라 읽기 / 쓰기 + 이미지 / v3-v4

public_share_url

사용자가 만드는 경우이 URL에 액세스 할 수 있습니다 비디오 스트림을 공개 .

세부
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
보고 string
예 : " https://video.nest.com/live/ string1 ? string2 "

string1 , 비디오 스트림 이름 중 사용자 정의 스트림이 공개로 설정되어 있으면 자동으로 생성하거나.
접속하다 읽기 전용
가능 카메라 읽기 + 이미지 / v3-v4
카메라 읽기 / 쓰기 + 이미지 / v3-v4

snapshot_url

필요에 따라 이미지를 캡처합니다. 라이브 비디오 스트림에서 캡처 한 이미지의 URL을 반환합니다. 카메라가 켜져 있고 활발하게 스트리밍되어야합니다.

이 필드를 사용하여 라이브 비디오 스트림에서 스냅 샷을 가져옵니다.

  • snapshot_url - 라이브 비디오 스트림에서 캡처 한 이미지의 URL을 반환
  • 카메라가 켜져 있고 활발하게 스트리밍되어야합니다.

API의 스냅 샷 품질은 다음과 같은 경우에만 1080p 처리량입니다.

  • 적극적 프로그램의 카메라 스트림을 볼 ( web_url )
  • 적극적 공개 스트림을 볼 ( app_url )
  • Nest Aware 구독

스트림을 적극적으로보고 있지 않거나 Nest Aware 구독이없는 경우 API에는 해당 해상도에서 스냅 샷을 검색하고 더 낮은 품질의 이미지를 생성 할 1080p 소스가 없습니다. 또한 낮은 로컬 네트워크 대역폭으로 인해 Nest Aware가있는 경우 API 스냅 샷 해상도가 1080p 아래로 떨어질 수 있습니다.

에 대해 자세히 알아 둥지 카메라에 대한 대역폭 요구 사항 .

속도 제한은 둥지 인식에 따라,이 호출에 적용 구독 상태 .

세부
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url
보고 string
예 : " string1 / device_id / string2 ?auth= camera_token "
접속하다 읽기 전용
가능 카메라 읽기 + 이미지 / v3-v4
카메라 읽기 / 쓰기 + 이미지 / v3-v4

last_event

이 개체는 알림을 트리거 한 마지막 이벤트에 대한 정보를 캡처합니다.

일부 필드 및 일부 권한 조합은 필요 둥지 인식 마지막 이벤트 정보에 액세스 할 구독을.

아래의 모든 값은 각각 아래 발견 devices/cameras/ device_id /last_event JSON 문서이다.

has_sound

사운드 이벤트-사운드가 감지되었습니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

has_motion

모션 이벤트-모션이 감지되었습니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

has_person

사람 이벤트-사람이 감지되었습니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
보고 boolean
값 : true, false
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

시작 시간

이벤트 시작 시간에 ISO 8601 형식입니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time
보고 string
예 : "2016-12-29T00 : 00 : 00.000Z"
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

end_time

이벤트 종료 시간에 ISO 8601 형식입니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time
보고 string
예 : "2016-12-29T00 : 00 : 00.000Z"
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

urls_expire_time

타임 스탬프에서 ISO 8601 형식으로, 그 식별이 이벤트 관련 URL의 만료 :

: 만료 시간으로 계산된다 last_event/start_time + N 일 (여기서, n = 10 또는 30 일 둥지 인식에 따라 가입 계획 ).

필요 둥지는 인식 .

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time
보고 string
예 : "2016-12-29T00 : 00 : 00.000Z"
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

web_url

웹 URL에서 마지막 소리 나 움직임 이벤트 (딥 링크) home.nest.com . 마지막으로 기록 된 이벤트를 표시하는 데 사용되며 사용자가 계정에 로그인해야합니다.

필요 둥지는 인식 . 이벤트 URL이 만료되었거나 디바이스에 활성 구독이없는 경우이 값은 페이로드에 포함되지 않습니다.

참조 last_event/urls_expire_time 이 URL의 만료 시간에 대한 정보.

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url
보고 string
예 : " https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token "
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

app_url

마지막 사운드 또는 모션 이벤트에 대한 Nest 앱 URL (딥 링크)입니다. 마지막으로 기록 된 이벤트를 표시하는 데 사용되며 사용자가 계정에 로그인해야합니다.

필요 둥지는 인식 . 이벤트 URL이 만료되었거나 디바이스에 활성 구독이없는 경우이 값은 페이로드에 포함되지 않습니다.

참조 last_event/urls_expire_time 이 URL의 만료 시간에 대한 정보.

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url
보고 string
예 : " nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token "
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

이미지 _URL

사운드 또는 모션 이벤트를 위해 캡처 된 이미지 파일의 URL (링크)입니다.

필요 둥지는 인식 . 참조 last_event/urls_expire_time 이 URL의 만료 시간에 대한 정보.

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url
보고 string
예 : " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
접속하다 읽기 전용
가능 카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 + 이미지 / v1-v4

animated_image_url

사운드 또는 모션 이벤트를 위해 캡처 된 gif 파일의 URL (링크)입니다.

필요 둥지는 인식 .

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url
보고 string
예 : " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
접속하다 읽기 전용
가능 카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 + 이미지 / v1-v4

activity_zone_ids

모션 이벤트를 감지 한 활동 영역의 식별자입니다.

필요 둥지는 인식 . 함께 사용하면 activity_zones 배열, 이러한 IDS에서 영역 이름을 얻을 수 있습니다.

만약 last_event/has_motion IS

  • true =는 모션 이벤트를 탐지 활동 영역 ID를 반환
  • false = 빈 배열을 반환
세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
보고 array
예 : [ string1 , string2 ,... ]
접속하다 읽기 전용
가능 카메라 읽기 + 이미지 / v3-v4
카메라 읽기 / 쓰기 + 이미지 / v3-v4