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

Camera API

Nest API는 모든 Nest CamTM 모델과 호환됩니다.

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

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

기기 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

집_ID

고유 식별자를 구성합니다.

세부정보
https://developer-api.nest.com/devices/cameras/device_id/structure_id
반환string
예: "VqFabWH21nw..."
액세스읽기 전용
제공 지역:카메라 읽기 / v1-v3
카메라 읽기 + 이미지 / v1-v4
카메라 읽기/쓰기 / v1-v3
카메라 읽기/쓰기 + 이미지 / v1-v4

where_id[ID_ID]

name(기기의 표시 이름)를 나타내는 고유한 Nest 생성 식별자입니다.

Nest 온도 조절기, 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

장소_이름

기기의 표시 이름입니다. Nest Cam where_id에 연결됩니다. 제공된 목록의 모든 채팅방 이름 또는 맞춤 이름을 사용할 수 있습니다. Nest 온도 조절기, Nest Protect, Nest Cam의 이름을 자세히 알아보세요.

세부정보
https://developer-api.nest.com/devices/cameras/device_id/where_name
반환string
예: "Hallway"
액세스읽기 전용
제공 지역:카메라 읽기 / v3
카메라 읽기 + 이미지 / v4
카메라 읽기/쓰기 / v3
카메라 읽기/쓰기 + 이미지 / v4

name

기기의 표시 이름입니다. Google에서 제공하는 목록의 회의실 이름 또는 맞춤 이름이 될 수 있습니다.

세부정보
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
값: 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

마지막_온라인_변경

온라인 상태의 마지막 변경사항을 식별하는 타임스탬프입니다(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

웹 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

앱 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

마지막_이벤트

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

일부 필드 및 일부 권한 조합에서는 마지막 이벤트 정보에 액세스하려면 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

start_time

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

url_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

웹 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

앱 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

image_url[이미지_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

애니메이션 이미지_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_id[활동_영역_ID]

모션 이벤트를 감지한 활동 감지 구역 식별자.

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