Google berkomitmen untuk memajukan ekuitas ras untuk komunitas kulit hitam. Lihat bagaimana.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

Referensi API Sarang

Nest API memodelkan rumah atau bangunan fisik sebagai suatu struktur, dengan Thermostat Pembelajaran Nest, Nest Protection, dan Nest Cams sebagai perangkat dalam struktur. Struktur ini juga berisi informasi tentang rumah secara keseluruhan (seperti status Away atau ETA, atau Jam Aktif).

Setiap elemen data dalam struktur dapat dialamatkan oleh URL sumber daya (disebut "lokasi data") dalam dokumen JSON bersama. Setiap lokasi data dapat menyimpan string, angka, boolean, objek induk / anak, atau array.

Jelajahi model data dengan Referensi API interaktif ini.

Dari API, Anda dapat menyinkronkan data dari lokasi di berbagai tingkatan dalam model data, misalnya:

  • seluruh struktur, termasuk semua perangkat
  • satu perangkat dalam suatu struktur
  • sekelompok nilai data (suhu saat ini dan sekitar)
  • nilai data tunggal (kondisi kesehatan baterai)

Produk Anda harus menanggapi dengan serius peristiwa-peristiwa seperti ini:

  • kehadiran (rumah dan jauh)
  • keamanan (asap dan karbon monoksida)
  • penggunaan energi pada waktu-waktu mahal dalam sehari
  • acara (suara dan gerak)

Namun, perlu diingat bahwa setiap objek berbasis perangkat berfungsi di bawah batasan dunia nyata. Sebagai contoh, termostat tidak boleh menjalankan AC ketika panas darurat diaktifkan. API kami dirancang untuk melindungi perangkat kami dan rumah pengguna, dan akan mencegah tindakan tertentu jika mereka mengejutkan atau berbahaya.

Izin dan data perangkat bersama

Kemampuan membaca atau menulis ke lokasi data dikendalikan oleh izin. Grup izin menyediakan akses baca, tulis, atau baca / tulis ke nilai data yang dipilih di perangkat dan struktur.

Untuk info lebih lanjut, lihat Tinjauan Izin .

Data dan privasi

Data yang terlibat dengan produk rumah bisa sangat pribadi. Data sensor rumah berisi informasi tentang bagaimana orang menjalani kehidupan mereka di ruang pribadi mereka. Keamanan dan penanganan data itu sangat penting, dan fokus yang signifikan di Nest. Kami menjelaskan kepada pengguna data apa yang kami miliki, bagaimana data itu digunakan, dan di mana mereka dapat mengendalikannya.

Pelajari lebih lanjut tentang pandangan kami tentang privasi .

Metadata

Metadata adalah informasi tambahan yang disediakan saat Anda melakukan panggilan ke titik akhir level root:

https://developer-api.nest.com/

access_token

Setelah otorisasi pengguna, produk Anda menggunakan token akses untuk melakukan panggilan API ke layanan Nest. Token akses ini berfungsi sebagai bukti bahwa pengguna telah mengotorisasi produk Anda untuk melakukan panggilan atas nama mereka.

Detail
Kembali string
Contoh: "c.FmDPkzyzaQe ..."

client_version

Versi klien adalah versi klien yang diotorisasi pengguna terakhir, dan dikaitkan dengan access_token .

Saat Anda memperbarui izin untuk klien, versi klien bertambah, dan pengguna diberi tahu bahwa pembaruan tersedia. Pengguna Anda harus menerima pembaruan klien ini sebelum mereka dapat menggunakan produk Anda yang diperbarui.

Detail
Kembali number
Contoh: 1, 17, 42

identitas pengguna

ID pengguna memungkinkan Anda mengidentifikasi pengguna di seluruh panggilan API. Pengidentifikasi ini berbeda untuk setiap produk Bekerja dengan Nest dan kombinasi pengguna.

Misalnya, jika pengguna 1 memiliki otorisasi Works with Nest product A dan Works with Nest product B, maka produk A memiliki satu nilai user_id untuk pengguna 1, dan produk B memiliki nilai user_id berbeda untuk pengguna 1.

Detail
Kembali string
Contoh: z.1.1.7DHps ...