API камеры

Nest API работает со всеми моделями Nest Cam ™.

Пользователи могут добавлять несколько Nest Cams в 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 , отображаемое имя устройства.

Узнайте больше о том, где названия Nest термостатов ,гнездо защищает и гнездо Cams .

Подробности
https://developer-api.nest.com/devices/cameras/ device_id /where_id
Возврат	string Пример: "d6reb_OZTM ..."
Доступ	только для чтения
Доступно в	Чтение камеры / v1-v3 Чтение камеры + изображения / v1-v4 Чтение / запись камеры / v1-v3 Чтение / запись камеры + изображения / v1-v4

где_имя

Отображаемое имя устройства. Связанное с гнездом Cam where_id . Может быть любое название комнаты из предоставленного нами списка или произвольное название. Узнайте больше о том, где названия Nest термостатов ,гнездо защищает и гнездо Cams .

Подробности
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

В сети

Состояние подключения устройства к службе Nest.

Подробности
https://developer-api.nest.com/devices/cameras/ device_id /is_online
Возврат	boolean Значения: истина, ложь
Доступ	только для чтения
Доступно в	Чтение камеры / v1-v3 Чтение камеры + изображения / v1-v4 Чтение / запись камеры / v1-v3 Чтение / запись камеры + изображения / v1-v4

is_streaming

Состояние камеры: включено и активно транслирует видео, или выключено. Смотрите , как ваша камера работает с Home / Away Assist для получения дополнительной информации.

Подробности
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

Web 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

URL-адрес приложения (глубокая ссылка) на прямой видеопоток в приложении Nest.

Подробности
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, из которого можно получить снимок с таким разрешением, и создается изображение более низкого качества. Кроме того, низкая пропускная способность локальной сети может привести к снижению разрешения снимка API ниже 1080p при наличии Nest Aware.

Подробнее о требованиях к пропускной способности для 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 подписки на доступ к последней информации о событии.

Все ниже значений находится в каждых devices/cameras/ device_id /last_event в документе JSON.

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

Отметка, в ISO 8601 в формате, который идентифицирует истечения этих URL - адресов связанных с событиями:

• last_event/web_url
• last_event/app_url
• last_event/image_url
• last_event/animated_image_url

Время истечения рассчитывается как: last_event/start_time + п дней (п = 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

Web URL (глубокая ссылка) до последнего звука или событий движения в home.nest.com . Используется для отображения последнего записанного события и требует, чтобы пользователь вошел в учетную запись.

Требуется Nest Aware . Если срок действия 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

Вложите URL-адрес приложения (глубокую ссылку) на последнее событие звука или движения. Используется для отображения последнего записанного события и требует, чтобы пользователь вошел в учетную запись.

Требуется Nest Aware . Если срок действия 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-адрес (ссылка) на файл изображения, записанный для события звука или движения.

Требуется Nest Aware . См 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

URL (ссылка) на файл gif, записанный для события звука или движения.

Требуется 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 массива, вы можете получить имя зоны из этих идентификаторов.

Если last_event/has_motion есть

• true = возвращает активность зоны идентификаторов , что обнаруженные события движения
• false = возвращает пустой массив

Подробности
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
Возврат	array Пример: [ string1 , string2 ,... ]
Доступ	только чтение
Доступно в	Чтение камеры + изображения / v3-v4 Чтение / запись камеры + изображения / v3-v4