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

카메라 API

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

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

아래의 모든 값은 JSON 문서의 각 devices/cameras/ device_id 아래에 있습니다.

장치 아이디

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 을 나타내는 고유 한 Nest 생성 식별자입니다.

Nest Thermostat ,Nest Protect , Nest Cam의 이름에 대해 자세히 알아보세요.

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

where_name

장치의 표시 이름입니다. Nest Cam where_id 와 연결됩니다. 우리가 제공하는 목록의 방 이름이나 사용자 지정 이름이 될 수 있습니다. Nest Thermostat ,Nest Protect , Nest Cam의 이름에 대해 자세히 알아보세요.

세부
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

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

세부
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

Nest Aware 구독 상태 (구독 활성화 여부).

세부
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

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

세부
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

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

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

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

string1 은 사용자가 정의하거나 영역이 생성 될 때 자동으로 생성되는 영역 이름입니다.
string2 는 활동 영역이 생성 될 때 Nest에서 할당 한 식별자입니다.
접속하다 읽기 전용
가능 카메라 읽기 + 이미지 / 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 아래로 떨어질 수 있습니다.

Nest 카메라의 대역폭 요구 사항에 대해 자세히 알아보세요.

이 통화에는 Nest Aware 구독 상태 에 따라 요금 제한이 적용됩니다.

세부
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

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

일부 필드 및 일부 권한 조합은 마지막 이벤트 정보에 액세스하려면 Nest Aware 구독이 필요합니다.

아래의 모든 값은 JSON 문서의 각 devices/cameras/ device_id /last_event 에 있습니다.

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

다음 이벤트 관련 URL의 만료를 식별하는 ISO 8601 형식의 타임 스탬프 :

만료 시간은 last_event/start_time + n 일 (여기서 n = 10 또는 30 일, Nest Aware 구독 계획 에 따라 다름)으로 계산됩니다.

Nest Aware가 필요합니다.

세부
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

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

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

이 URL의 만료 시간에 대한 정보는 last_event/urls_expire_time 을 참조하십시오.

세부
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 (딥 링크)입니다. 마지막으로 기록 된 이벤트를 표시하는 데 사용되며 사용자가 계정에 로그인해야합니다.

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

이 URL의 만료 시간에 대한 정보는 last_event/urls_expire_time 을 참조하십시오.

세부
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 (링크)입니다.

Nest Aware가 필요합니다. 이 URL의 만료 시간에 대한 정보는 last_event/urls_expire_time 을 참조하십시오.

세부
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 (링크)입니다.

Nest Aware가 필요합니다.

세부
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

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

Nest Aware가 필요합니다. activity_zones 배열과 함께 사용하면 이러한 ID에서 영역 이름을 가져올 수 있습니다.

last_event/has_motion

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