Nest API berfungsi dengan semua model Nest CamTM.
Pengguna dapat menambahkan beberapa Nest Cam ke grup devices/cameras
, hingga
maksimum per
struktur.
Saat melakukan panggilan ke lokasi data ini, Anda dapat mengakses data Nest Cam (nilai
data untuk perangkat dalam struktur).
Semua nilai di bawah ini ditemukan dalam setiap devices/cameras/device_id
di dokumen JSON.
id_perangkat
ID unik Nest Cam.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/device_id |
|
Menampilkan | string Contoh: "awJo6rH..." |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
software_version
Versi software.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/software_version |
|
Menampilkan | string Contoh: "4.0" |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
id_struktur
Membuat ID unik.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/structure_id |
|
Menampilkan | string Contoh: "VqFabWH21nw..." |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
di mana_id
ID unik yang dihasilkan Nest yang mewakili
name
, nama tampilan perangkat.
Pelajari lebih lanjut nama untuk Nest Thermostat, Nest Protect, dan Nest Cam.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/where_id |
|
Menampilkan | string Contoh: "d6reb_OZTM..." |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
nama_di mana
Nama tampilan perangkat. Diatribusikan dengan Nest Cam
where_id
. Dapat berupa nama ruangan apa pun dari daftar
yang kami berikan, atau nama kustom. Pelajari lebih lanjut nama untuk Nest Thermostat, Nest Protect, dan Nest Cam.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/where_name |
|
Menampilkan | string Contoh: "Hallway" |
Akses | hanya baca |
Tersedia di | Kamera baca / v3 Baca kamera + gambar / v4 Baca kamera/tulis / v3 Kamera baca/tulis + gambar / v4 |
nama
Nama tampilan perangkat; dapat berupa nama ruangan apa pun dari daftar yang kami berikan, atau nama kustom.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/name |
|
Menampilkan | string Contoh: "Hallway" |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
nama_panjang
Nama tampilan panjang perangkat. Mencakup kustom (label), yang dibuat oleh pengguna,
atau melalui wheres
.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/name_long |
|
Menampilkan | string Contoh: "Hallway Nest Cam (lantai atas)" |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
is_online [online_is]
Status koneksi perangkat dengan layanan Nest.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/is_online |
|
Menampilkan | boolean Nilai: benar, salah |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
is_streaming
Status kamera, baik aktif maupun tidak aktif melakukan streaming video, atau nonaktif. Lihat Cara kerja kamera dengan Bantuan Mode Di Rumah/Pergi untuk informasi selengkapnya.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/is_streaming |
|
Menampilkan | boolean Nilai: benar, salah |
Akses | baca/tulis |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
is_audio_input_enabled
Status mikrofon kamera, baik aktif maupun tidak, atau nonaktif. Pelajari lebih lanjut setelan audio Nest Cam.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/is_audio_input_enabled |
|
Menampilkan | boolean Nilai: benar, salah |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
last_is_online_change [perubahan_online_terakhir]
Stempel waktu yang mengidentifikasi perubahan terakhir pada status online, dalam format ISO 8601.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_is_online_change |
|
Menampilkan | string Contoh: "2016-12-29T18:42:00.000Z" |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
is_video_history_enabled
Status langganan Nest Aware (langganan aktif atau tidak).
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/is_video_history_enabled |
|
Menampilkan | boolean Nilai: benar, salah |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
url_web
URL web (deep link) ke streaming video live di home.nest.com.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/web_url |
|
Menampilkan | string Contoh: " https://home.nest.com/cameras/device_id?auth=camera_token " |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
url_aplikasi
URL aplikasi (deep link) ke streaming video live di aplikasi Nest.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/app_url |
|
Menampilkan | string Contoh: " nestmobile://cameras/device_id?auth=camera_token " |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
is_public_share_enabled
Pengguna dapat memilih untuk membagikan
videonya
dan membuatnya dapat dilihat oleh siapa saja. Ketika berbagi publik diaktifkan, Anda dapat membaca
public_share_url
.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/is_public_share_enabled |
|
Menampilkan | boolean Nilai: benar, salah |
Akses | hanya baca |
Tersedia di | Kamera membaca + gambar / v3-v4 Kamera baca/tulis + gambar / v3-v4 |
aktivitas_zona
Menampilkan array semua Zona Aktivitas yang ditentukan.
Zona Aktivitas digunakan untuk memantau peristiwa gerakan dalam area streaming video yang ditentukan pengguna. Memerlukan Nest Aware.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/activity_zones |
|
Menampilkan | array Contoh: [ {"name" : "string1", "id" : "string2"},... ] • string1 adalah nama zona, baik yang ditentukan pengguna maupun yang dihasilkan secara otomatis saat zona dibuat.• string2 adalah ID yang ditetapkan oleh Nest saat Zona Aktivitas dibuat. |
Akses | hanya baca |
Tersedia di | Kamera membaca + gambar / v3-v4 Kamera baca/tulis + gambar / v3-v4 |
url_bagikan_publik
Anda dapat mengakses URL ini saat pengguna membuat streaming streaming video menjadi publik.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/public_share_url |
|
Menampilkan | string Contoh: " https://video.nest.com/live/string1?string2 "string1 adalah nama streaming video, baik yang ditentukan pengguna maupun yang dibuat otomatis saat streaming disetel ke publik. |
Akses | hanya baca |
Tersedia di | Kamera membaca + gambar / v3-v4 Kamera baca/tulis + gambar / v3-v4 |
url_snapshot
Ambil gambar sesuai permintaan. Menampilkan URL gambar yang diambil dari streaming video live. Kamera harus aktif dan melakukan streaming secara aktif.
Gunakan kolom ini untuk mendapatkan ringkasan dari streaming video live.
snapshot_url
- menampilkan URL gambar yang diambil dari streaming video live- Mengharuskan kamera aktif dan melakukan streaming secara aktif
Kualitas snapshot dari API hanya throughput 1080p jika Anda:
- melihat streaming kamera secara aktif dalam aplikasi
(
web_url
) - melihat streaming publik secara aktif
(
app_url
) - berlangganan Nest Aware
Jika Anda tidak aktif melihat streaming atau tidak memiliki langganan Nest Aware, API tidak memiliki sumber 1080p untuk mengambil snapshot pada resolusi tersebut dan menghasilkan gambar berkualitas lebih rendah. Selain itu, bandwidth jaringan lokal yang rendah dapat menyebabkan resolusi snapshot API turun di bawah 1080p dengan adanya Nest Aware.
Pelajari persyaratan bandwidth untuk Kamera Nest lebih lanjut.
Batas kapasitas berlaku untuk panggilan ini, bergantung pada status langganan Nest Aware.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/snapshot_url |
|
Menampilkan | string Contoh: " string1/device_id/string2?auth=camera_token " |
Akses | hanya baca |
Tersedia di | Kamera membaca + gambar / v3-v4 Kamera baca/tulis + gambar / v3-v4 |
peristiwa_terakhir
Objek ini menangkap informasi tentang peristiwa terakhir yang memicu notifikasi.
Beberapa kolom dan beberapa kombinasi izin memerlukan langganan Nest Aware untuk mengakses informasi peristiwa terakhir.
Semua nilai di bawah ini ditemukan dalam setiap devices/cameras/device_id/last_event
di dokumen JSON.
memiliki_suara
Peristiwa suara - suara terdeteksi.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_sound |
|
Menampilkan | boolean Nilai: benar, salah |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
has_motion
Peristiwa gerakan - gerakan terdeteksi.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_motion |
|
Menampilkan | boolean Nilai: benar, salah |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
has_person [nama_orang]
Peristiwa orang - orang terdeteksi.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_person |
|
Menampilkan | boolean Nilai: benar, salah |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
start_time
Waktu mulai acara, dalam format ISO 8601.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/start_time |
|
Menampilkan | string Contoh: "2016-12-29T00:00:00.000Z" |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
end_time
Waktu berakhir acara, dalam format ISO 8601.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/end_time |
|
Menampilkan | string Contoh: "2016-12-29T00:00:00.000Z" |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
url_expire_time
Stempel waktu, dalam format ISO 8601, yang mengidentifikasi berakhirnya URL terkait peristiwa ini:
Waktu habis masa berlaku dihitung sebagai:
last_event/start_time
+ n hari (dengan n =
10 atau 30 hari, bergantung pada paket
langganan Nest Aware).
Memerlukan Nest Aware.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/urls_expire_time |
|
Menampilkan | string Contoh: "2016-12-29T00:00:00.000Z" |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
url_web
URL web (deep link) ke peristiwa suara atau gerakan terakhir di home.nest.com. Digunakan untuk menampilkan peristiwa terakhir yang direkam, dan mengharuskan pengguna login ke akun.
Memerlukan Nest Aware. Jika URL peristiwa telah habis masa berlakunya atau perangkat tidak memiliki langganan aktif, nilai ini tidak akan disertakan dalam payload.
Lihat last_event/urls_expire_time
untuk
mengetahui informasi tentang waktu habis masa berlaku URL ini.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/web_url |
|
Menampilkan | string Contoh: " https://home.nest.com/cameras/device_id/cuepoints/string?auth=camera_token " |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
url_aplikasi
URL aplikasi Nest (deep link) ke peristiwa gerakan atau suara terakhir. Digunakan untuk menampilkan peristiwa yang terakhir dicatat, dan mengharuskan pengguna untuk login ke akun.
Memerlukan Nest Aware. Jika URL peristiwa telah habis masa berlakunya atau perangkat tidak memiliki langganan aktif, nilai ini tidak akan disertakan dalam payload.
Lihat last_event/urls_expire_time
untuk
mengetahui informasi tentang waktu habis masa berlaku URL ini.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/app_url |
|
Menampilkan | string Contoh: " nestmobile://cameras/device_id/cuepoints/string?auth=camera_token " |
Akses | hanya baca |
Tersedia di | Kamera baca / v1-v3 Kamera dibaca + gambar / v1-v4 Kamera baca/tulis / v1-v3 Baca/tulis kamera + gambar / v1-v4 |
url_gambar
URL (link) ke file gambar yang diambil untuk peristiwa suara atau gerakan.
Memerlukan Nest Aware. Lihat
last_event/urls_expire_time
untuk
mengetahui informasi tentang waktu habis masa berlaku URL ini.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/image_url |
|
Menampilkan | string Contoh: " https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token " |
Akses | hanya baca |
Tersedia di | Kamera baca + gambar / v1-v4 Kamera baca/tulis + gambar / v1-v4 |
animasi_image_url
URL (link) ke file gif yang ditangkap untuk peristiwa suara atau gerakan.
Memerlukan Nest Aware.
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/animated_image_url |
|
Menampilkan | string Contoh: " https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token " |
Akses | hanya baca |
Tersedia di | Kamera baca + gambar / v1-v4 Kamera baca/tulis + gambar / v1-v4 |
id_zona_aktivitas
ID untuk Zona Aktivitas yang mendeteksi peristiwa gerakan.
Memerlukan Nest Aware. Jika digunakan dengan array activity_zones
, Anda bisa mendapatkan nama zona dari ID ini.
Jika last_event/has_motion
adalah
true
= menampilkan ID zona aktivitas yang mendeteksi peristiwa gerakanfalse
= menampilkan array kosong
Detail | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/activity_zone_ids |
|
Menampilkan | array Contoh: [ string1, string2,... ] |
Akses | hanya baca |
Tersedia di | Kamera membaca + gambar / v3-v4 Kamera baca/tulis + gambar / v3-v4 |