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

Referensi Nest API

Nest API memodelkan rumah atau bangunan fisik sebagai struktur, dengan Nest Learning Thermostats, Nest Protects, dan Nest Cams sebagai perangkat dalam struktur tersebut. Struktur ini juga berisi informasi tentang rumah secara keseluruhan (seperti Tidak di tempat atau status ETA, atau Jam Sibuk yang aktif).

Setiap elemen data dalam struktur dapat dialamatkan oleh URL sumber daya (disebut "lokasi data") di 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 level dalam model data, misalnya:

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

Produk Anda harus menanggapi peristiwa seperti ini dengan cermat:

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

Namun, perlu diingat bahwa setiap objek berbasis perangkat bekerja di bawah batasan dunia nyata. Misalnya, termostat tidak boleh menjalankan AC saat pemanas darurat diaktifkan. API kami dirancang untuk melindungi perangkat kami dan rumah pengguna, dan akan mencegah tindakan tertentu yang mengejutkan atau berbahaya.

Izin dan data perangkat bersama

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

Untuk info selengkapnya, lihat Ringkasan Izin .

Data dan privasi

Data yang terkait dengan produk rumahan bisa sangat pribadi. Data sensor rumah berisi informasi tentang bagaimana orang menjalani kehidupannya di ruang pribadinya. Keamanan dan penanganan data tersebut sangat penting, dan fokus yang signifikan di Nest. Kami menjelaskan kepada pengguna jenis data yang kami miliki, bagaimana penggunaannya, dan di mana mereka dapat mengontrolnya.

Pelajari lebih lanjut tentang pandangan kami tentang privasi .

Metadata

Metadata adalah informasi tambahan yang diberikan saat Anda melakukan panggilan ke titik akhir tingkat akar:

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 mengizinkan produk Anda untuk melakukan panggilan atas nama mereka.

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

client_version

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

Ketika Anda memperbarui izin untuk klien, versi klien bertambah, dan pengguna diberitahu 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. Pengenal ini berbeda untuk setiap produk Works with Nest dan kombinasi pengguna.

Misalnya, jika pengguna 1 telah memberi otorisasi Works with Nest produk A dan Works dengan produk Nest 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 ...