Notice: We're retiring Works with Nest. See the home page for more information.

Halaman ini diterjemahkan oleh Cloud Translation API.

Camera API

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. Perhatian:`string2` digunakan untuk melakukan panggilan API. Jangan ubah string atau panggilan akan gagal.
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`" Perhatian:`string1` dan `string2` digunakan untuk melakukan panggilan API. Jangan ubah string apa pun atau panggilan akan gagal.
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:

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

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`" Perhatian:`string1` dan `string2` digunakan untuk melakukan panggilan API. Jangan ubah string apa pun atau panggilan akan gagal.
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`" Perhatian:`string1` dan `string2` digunakan untuk melakukan panggilan API. Jangan ubah string apa pun atau panggilan akan gagal.
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 gerakan
false = 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