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

카메라 API

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

사용자는 여러 개의 Nest Cam을 devices/cameras 그룹에 최대 구조 당 최대 추가 할 수 있습니다. 이 데이터 위치를 호출하면 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 온도 조절기 , Nest ProtectsNest 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 온도 조절기 , Nest ProtectsNest Cam의 이름에 대해 자세히 알아보십시오.

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

이름

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

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

name_long

장치의 긴 표시 이름입니다. 사용자가 작성하거나 wheres 를 통해 사용자 정의 (라벨)를 포함합니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /name_long
보고 string
예 : "Hallway 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
값 : 참, 거짓
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

is_streaming

카메라 상태 (켜거나 활발하게 비디오 스트리밍 또는 끄기) 자세한 내용 은 카메라가 홈 / 어웨이 어시스트와 작동하는 방식 을 참조하십시오.

세부
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
보고 boolean
값 : 참, 거짓
접속하다 읽기 / 쓰기
가능 카메라 읽기 / 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
값 : 참, 거짓
접속하다 읽기 전용
가능 카메라 읽기 / 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
값 : 참, 거짓
접속하다 읽기 전용
가능 카메라 읽기 / 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
값 : 참, 거짓
접속하다 읽기 전용
가능 카메라 읽기 + 이미지 / 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
값 : 참, 거짓
접속하다 읽기 전용
가능 카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기 / 쓰기 / v1-v3
카메라 읽기 / 쓰기 + 이미지 / v1-v4

has_motion

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

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

has_person

개인 이벤트-개인이 감지되었습니다.

세부
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
보고 boolean
값 : 참, 거짓
접속하다 읽기 전용
가능 카메라 읽기 / 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

종료 시간

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 일 (Nest Aware 구독 계획 에 따라 n = 10 또는 30 일)로 계산됩니다.

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

마지막 사운드 또는 모션 이벤트에 앱 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

image_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