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 bekerja dengan semua model Nest Cam ™.

Pengguna dapat menambahkan beberapa Nest Nest ke grup devices/cameras , hingga 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 dalam dokumen JSON.

device_id

Pengidentifikasi unik Nest Cam.

Detail
https://developer-api.nest.com/devices/cameras/ device_id /device_id
Kembali string
Contoh: "awJo6rH ..."
Mengakses hanya baca
Tersedia di Kamera baca / 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 di Kamera baca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

structure_id

Struktur pengidentifikasi unik.

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

where_id

Pengidentifikasi unik yang dibuat oleh Nest yang mewakili name , nama tampilan perangkat.

Pelajari lebih lanjut tentang di mana nama untuk Termostat Sarang , Perlindungan Sarang , dan Sarang Cams .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /where_id
Kembali string
Contoh: "d6reb_OZTM ..."
Mengakses hanya baca
Tersedia di Kamera baca / 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 . Dapat berupa nama ruangan apa pun dari daftar yang kami sediakan, atau nama khusus. Pelajari lebih lanjut tentang di mana nama untuk Termostat Sarang , Perlindungan Sarang , dan Sarang Cams .

Detail
https://developer-api.nest.com/devices/cameras/ device_id /where_name
Kembali string
Contoh: "Lorong"
Mengakses hanya baca
Tersedia di Kamera baca / v3
Kamera baca + 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: "Lorong"
Mengakses hanya baca
Tersedia di Kamera baca / 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 di Kamera baca / 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 di Kamera baca / 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 streaming video aktif, atau tidak aktif. 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 di Kamera baca / 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, baik hidup dan mendengarkan, atau mati. Pelajari lebih lanjut tentang pengaturan 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 di Kamera baca / 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 mengidentifikasi perubahan terakhir ke 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 di Kamera baca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

is_video_history_enabled

Status berlangganan Nest Sadar (berlangganan 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 di Kamera baca / 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 di Kamera baca / 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 di Kamera baca / 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. Saat berbagi 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 di Kamera membaca + gambar / v3-v4
Kamera baca / tulis + gambar / v3-v4

activity_zones

Mengembalikan array dari semua Zona Aktivitas yang ditetapkan.

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

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

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

public_share_url

Anda dapat mengakses URL ini ketika pengguna membuat aliran videonya 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 aliran video, baik yang ditentukan pengguna atau dibuat secara otomatis ketika aliran diatur ke publik.
Mengakses hanya baca
Tersedia di Kamera membaca + gambar / v3-v4
Kamera baca / tulis + gambar / v3-v4

snapshot_url

Abadikan gambar sesuai permintaan. Mengembalikan URL gambar yang diambil dari streaming video langsung. Mengharuskan kamera aktif dan aktif streaming.

Gunakan bidang ini untuk mendapatkan snapshot dari streaming video langsung.

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

Kualitas snapshot dari API hanya throughput 1080p jika Anda:

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

Jika Anda tidak secara aktif melihat aliran atau tidak memiliki langganan Nest Sadar, API tidak memiliki sumber 1080p untuk mengambil snapshot pada resolusi itu dan menghasilkan gambar berkualitas lebih rendah. Juga, bandwidth jaringan lokal yang rendah dapat menyebabkan resolusi snapshot API turun di bawah 1080p dengan Nest Sadar.

Pelajari lebih lanjut tentang persyaratan bandwidth untuk Kamera Nest .

Batas tarif berlaku untuk panggilan ini, tergantung pada status berlangganan Nest Sadar.

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 di Kamera membaca + gambar / v3-v4
Kamera baca / tulis + gambar / v3-v4

acara terakhir

Objek ini menangkap informasi tentang peristiwa terakhir yang memicu pemberitahuan.

Beberapa bidang dan beberapa kombinasi izin memerlukan berlangganan Nest Sadar untuk mengakses informasi acara terakhir.

Semua nilai di bawah ini ditemukan di bawah setiap devices/cameras/ device_id /last_event dalam 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 di Kamera baca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

has_motion

Acara gerak - 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 di Kamera baca / 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 di Kamera baca / 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 di Kamera baca / v1-v3
Kamera membaca + gambar / v1-v4
Kamera baca / tulis / v1-v3
Kamera baca / tulis + gambar / v1-v4

akhir waktu

Waktu akhir 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 di Kamera baca / 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 kedaluwarsa URL terkait peristiwa ini:

Waktu last_event/start_time dihitung sebagai: last_event/start_time + n hari (di mana n = 10 atau 30 hari, tergantung pada rencana berlangganan Nest Sadar).

Membutuhkan Nest Sadar .

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 di Kamera baca / 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 yang terakhir direkam, dan mengharuskan pengguna masuk ke akun.

Membutuhkan Nest Sadar . Jika URL acara telah kedaluwarsa atau perangkat tidak memiliki langganan aktif, maka nilai ini tidak termasuk dalam muatan.

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 di Kamera baca / 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 acara suara atau gerakan terakhir. Digunakan untuk menampilkan acara yang terakhir direkam, dan mengharuskan pengguna masuk ke akun.

Membutuhkan Nest Sadar . Jika URL acara telah kedaluwarsa atau perangkat tidak memiliki langganan aktif, maka nilai ini tidak termasuk dalam muatan.

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 di Kamera baca / 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 Sadar . 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 di 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 Sadar .

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 di Kamera membaca + gambar / v1-v4
Kamera baca / tulis + gambar / v1-v4

activity_zone_ids

Pengidentifikasi untuk Zona Aktivitas yang mendeteksi peristiwa gerakan.

Membutuhkan Nest Sadar . 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 array 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 di Kamera membaca + gambar / v3-v4
Kamera baca / tulis + gambar / v3-v4