Notice: We're retiring Works with Nest. See the home page for more information.
Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

API Kamera

Nest API berfungsi dengan semua model Nest Cam ™.

Pengguna dapat menambahkan beberapa Nest Cam ke grup devices/cameras , hingga jumlah maksimum per struktur . Saat Anda melakukan panggilan ke lokasi data ini, Anda dapat mengakses data Nest Cam (nilai data untuk perangkat dalam struktur).

Semua nilai di bawah ini ditemukan di bawah setiap devices/cameras/ device_id di dokumen JSON.

device_id

ID unik Nest Cam.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /device_id
Kembali string
Contoh: "awJo6rH ..."
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

versi perangkat lunak

Versi perangkat lunak.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /software_version
Kembali string
Contoh: "4.0"
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

structure_id

Buat struktur pengenal unik.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
Kembali string
Contoh: "VqFabWH21nw ..."
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

where_id

Pengenal unik buatan Nest yang mewakili name , nama tampilan perangkat.

Pelajari lebih lanjut tentang di mana nama TermostatNest , PerlindunganNest , dan Nest Cam .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /where_id
Kembali string
Contoh: "d6reb_OZTM ..."
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

where_name

Nama tampilan perangkat. Terkait dengan Nest Cam where_id . Bisa nama kamar apa pun dari daftar yang kami sediakan, atau nama khusus. Pelajari lebih lanjut tentang di mana nama TermostatNest , PerlindunganNest , dan Nest Cam .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /where_name
Kembali string
Contoh: "Hallway"
Mengakses hanya baca
Tersedia dalam Kamera membaca / v3
Kamera membaca + gambar / v4
Kamera baca / tulis / v3
Kamera baca / tulis + gambar / v4

nama

Nama tampilan perangkat; dapat berupa nama kamar apa pun dari daftar yang kami sediakan, atau nama khusus.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /name
Kembali string
Contoh: "Hallway"
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

name_long

Nama tampilan panjang perangkat. Termasuk custom (label), dibuat oleh pengguna, atau melalui wheres .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /name_long
Kembali string
Contoh: "Hallway Nest Cam (lantai atas)"
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

sedang on line

Status koneksi perangkat dengan layanan Nest.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /is_online
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

is_streaming

Status kamera, baik aktif dan aktif streaming video, atau mati. Lihat Bagaimana kamera Anda bekerja dengan Home / Away Assist untuk informasi lebih lanjut.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
Kembali boolean
Nilai: benar, salah
Mengakses Baca tulis
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

is_audio_input_enabled

Status mikrofon kamera, aktif dan mendengarkan, atau mati. Pelajari lebih lanjut tentang setelan audio Nest Cam .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

last_is_online_change

Stempel waktu yang menunjukkan perubahan terakhir pada status online, dalam format ISO 8601 .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change
Kembali string
Contoh: "2016-12-29T18: 42: 00.000Z"
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + 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
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

web_url

URL web (tautan dalam) ke aliran video langsung di home.nest.com .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /web_url
Kembali string
Contoh: " https://home.nest.com/cameras/ device_id ?auth= camera_token "
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

app_url

URL aplikasi (tautan dalam) ke streaming video langsung di aplikasi Nest.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /app_url
Kembali string
Contoh: " nestmobile://cameras/ device_id ?auth= camera_token "
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

is_public_share_enabled

Pengguna dapat memilih untuk membagikan video mereka dan membuatnya dapat dilihat oleh siapa saja. Jika pembagian publik diaktifkan, Anda dapat membaca public_share_url .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia dalam Kamera membaca + gambar / v3-v4
Kamera baca / tulis + gambar / v3-v4

zona_aktivitas

Mengembalikan larik dari semua Zona Aktivitas yang ditentukan.

Zona Aktivitas digunakan untuk memantau kejadian gerakan dalam area yang ditentukan pengguna dari aliran video. Membutuhkan Nest Aware .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
Kembali array
Contoh: [ {"name" : " string1 ", "id" : " string2 "},... ]

string1 adalah nama zona, baik ditentukan pengguna atau dibuat secara otomatis saat zona dibuat.
string2 adalah pengenal yang ditetapkan oleh Nest saat Zona Aktivitas dibuat.
Mengakses hanya baca
Tersedia dalam Kamera membaca + gambar / v3-v4
Kamera baca / tulis + gambar / v3-v4

public_share_url

Anda dapat mengakses URL ini ketika pengguna menjadikan aliran video mereka publik .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
Kembali string
Contoh: " https://video.nest.com/live/ string1 ? string2 "

string1 adalah nama streaming video, baik ditentukan pengguna atau dibuat secara otomatis saat streaming disetel ke publik.
Mengakses hanya baca
Tersedia dalam Kamera membaca + gambar / v3-v4
Kamera baca / tulis + gambar / v3-v4

snapshot_url

Tangkap gambar sesuai permintaan. Menampilkan URL gambar yang diambil dari aliran video langsung. Mengharuskan kamera menyala dan melakukan streaming secara aktif.

Gunakan bidang ini untuk mendapatkan cuplikan dari streaming video langsung.

  • snapshot_url - mengembalikan URL gambar yang diambil dari streaming video langsung
  • Mengharuskan kamera menyala dan melakukan streaming secara aktif

Kualitas snapshot dari API hanya 1080p throughput jika Anda:

  • aktif melihat aliran kamera di aplikasi ( web_url )
  • aktif melihat aliran publik ( app_url )
  • berlangganan Nest Aware

Jika Anda tidak secara 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 lebih lanjut tentang persyaratan bandwidth untuk Kamera Nest .

Batas tarif berlaku untuk panggilan ini, bergantung pada status langganan Nest Aware.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url
Kembali string
Contoh: " string1 / device_id / string2 ?auth= camera_token "
Mengakses hanya baca
Tersedia dalam Kamera membaca + gambar / v3-v4
Kamera baca / tulis + gambar / v3-v4

peristiwa_khir

Objek ini menangkap informasi tentang peristiwa terakhir yang memicu pemberitahuan.

Beberapa bidang dan beberapa kombinasi izin memerlukan langganan Nest Aware untuk mengakses informasi acara terakhir.

Semua nilai di bawah ini ditemukan di bawah setiap devices/cameras/ device_id /last_event di dokumen JSON.

has_sound

Peristiwa suara - suara terdeteksi.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

has_motion

Peristiwa gerakan - gerakan terdeteksi.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

has_person

Peristiwa orang - seseorang terdeteksi.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
Kembali boolean
Nilai: benar, salah
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

waktu mulai

Waktu mulai acara, dalam format ISO 8601 .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time
Kembali string
Contoh: "2016-12-29T00: 00: 00.000Z"
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

akhir waktu

Waktu berakhir acara, dalam format ISO 8601 .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time
Kembali string
Contoh: "2016-12-29T00: 00: 00.000Z"
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

urls_expire_time

Stempel waktu, dalam format ISO 8601 , yang mengidentifikasi berakhirnya URL terkait peristiwa berikut:

Waktu last_event/start_time dihitung dengan last_event/start_time : last_event/start_time + n hari (di mana n = 10 atau 30 hari, bergantung pada paket langganan Nest Aware).

Membutuhkan Nest Aware .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time
Kembali string
Contoh: "2016-12-29T00: 00: 00.000Z"
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

web_url

URL web (tautan dalam) ke acara suara atau gerakan terakhir di home.nest.com . Digunakan untuk menampilkan acara terakhir yang direkam, dan mengharuskan pengguna untuk masuk ke akun.

Membutuhkan Nest Aware . Jika URL peristiwa telah kedaluwarsa atau perangkat tidak memiliki langganan aktif, nilai ini tidak termasuk dalam payload.

Lihat last_event/urls_expire_time untuk informasi tentang waktu kedaluwarsa URL ini.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url
Kembali string
Contoh: " https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token "
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

app_url

URL aplikasi Nest (tautan dalam) ke peristiwa suara atau gerakan terakhir. Digunakan untuk menampilkan acara terakhir yang direkam, dan mengharuskan pengguna untuk masuk ke akun.

Membutuhkan Nest Aware . Jika URL peristiwa telah kedaluwarsa atau perangkat tidak memiliki langganan aktif, maka nilai ini tidak termasuk dalam payload.

Lihat last_event/urls_expire_time untuk informasi tentang waktu kedaluwarsa URL ini.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url
Kembali string
Contoh: " nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token "
Mengakses hanya baca
Tersedia dalam Kamera membaca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

image_url

URL (tautan) ke file gambar yang diambil untuk acara suara atau gerakan.

Membutuhkan Nest Aware . Lihat last_event/urls_expire_time untuk informasi tentang waktu kedaluwarsa URL ini.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url
Kembali string
Contoh: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Mengakses hanya baca
Tersedia dalam Kamera membaca + gambar / v1-v4
Kamera baca / tulis + gambar / v1-v4

animated_image_url

URL (tautan) ke file gif yang diambil untuk acara suara atau gerakan.

Membutuhkan Nest Aware .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url
Kembali string
Contoh: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Mengakses hanya baca
Tersedia dalam Kamera membaca + gambar / v1-v4
Kamera baca / tulis + gambar / v1-v4

activity_zone_ids

Pengidentifikasi untuk Zona Aktivitas yang mendeteksi kejadian gerakan.

Membutuhkan Nest Aware . Saat digunakan dengan larik activity_zones , Anda bisa mendapatkan nama zona dari id ini.

Jika last_event/has_motion adalah

  • true = mengembalikan id zona aktivitas yang mendeteksi peristiwa gerakan
  • false = mengembalikan larik kosong
Detail
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
Kembali array
Contoh: [ string1 , string2 ,... ]
Mengakses hanya baca
Tersedia dalam Kamera membaca + gambar / v3-v4
Kamera baca / tulis + gambar / v3-v4