Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Arsitektur Nest API

Tentang layanan Nest

Aplikasi Nest memungkinkan pengguna untuk terhubung dengan rumah mereka dari mana pun mereka berada. Semua perangkat Nest (Termostat, Protect, dan Kamera) dan aplikasi (iOS, Android, dan aplikasi web) terhubung ke layanan Nest.

Contoh cloud-to-cloud

Layanan Nest menyediakan model data rumah. Perangkat dan aplikasi membaca dari model data ini untuk mengambil tindakan yang sesuai. Mereka memperbarui model data untuk mencerminkan perubahan dalam sistem.

Misalnya, termostat membaca suhu targetnya dari model data. Atribut ini menyetel suhu sekitar ke pengukuran saat ini, dan mengirimkan data sensor ke Bantuan Mode Di Rumah/Pergi, yang menyesuaikan mode strukturnya.

Perangkat Nest beroperasi di lingkungan terbatas. Daya terbatas dan konektivitas jaringan rumah mungkin tidak bisa diandalkan. Produk dan layanan Anda dapat memanfaatkan algoritme perangkat kami untuk menawarkan pengalaman rumah yang mudah dan intuitif kepada pengguna.

Model data

Nest API direpresentasikan sebagai dokumen JSON dengan atribut level atas metadata, devices, dan structures. Produk Works with Nest Anda menggunakan dokumen JSON ini untuk berinteraksi dengan, dan bereaksi terhadap, perangkat Nest dan perubahan status terkait.

structures Nest merepresentasikan struktur fisik di dunia nyata. Alat ini berfungsi sebagai titik penyusunan untuk devices dan menyimpan data untuk bangunan secara keseluruhan. Biasanya, structure adalah rumah pengguna.

devices Nest mewakili perangkat fisik (Termostat, Protect, dan Kamera) dalam struktur.

Setiap elemen data dalam dokumen JSON dapat dipanggil berdasarkan URL (juga dikenal sebagai "lokasi data"). Produk Works with Nest dapat membaca dan menulis ke bagian dokumen ini dan berlangganan perubahan. Kemampuan langganan ini memungkinkan produk Works with Nest untuk merespons perubahan yang dibuat pada sistem secara real time, seperti mematikan lampu saat pengguna menetapkan struktur ke Away.

Objek juga bekerja dalam batasan dunia nyata. Model data mengamankan perangkat dan rumah pengguna dengan mencegah tindakan yang mengejutkan dan berbahaya. Misalnya, termostat tidak menjalankan AC saat panas darurat diaktifkan.

Pelajari model data dengan Referensi API interaktif ini.

Status yang dimaksudkan

Layanan Nest menyimpan status resmi sistem, dan produk yang Kompatibel dengan Nest berlangganan perubahan. Mengubah status ini (misalnya, untuk mengubah suhu target termostat) menyebabkan layanan mengirimkan notifikasi perubahan ke semua pelanggan.

Karena penerapan ini memiliki beberapa penundaan dan jaringan dapat menjadi tidak dapat diandalkan, status yang diamati oleh produk mungkin bukan status yang saat ini diamati oleh produk atau layanan lain. Status pada akhirnya disinkronkan saat pesan dikirim di antara berbagai produk.

Model publikasi/langganan yang berorientasi pada dokumen ini memberikan interaksi aplikasi yang responsif.

Menggunakan layanan Nest

Untuk mengakses endpoint REST di layanan Nest, gunakan HTTPS di produk Anda. Ada banyak library klien pihak ketiga yang dapat digunakan untuk tujuan ini.

Izin dan otorisasi

Kami ingin mengizinkan developer membuat produk dan layanan yang menjadikan rumah lebih baik, tanpa mengorbankan privasi dan keamanan pengguna. Semua komunikasi kami aman, dan izin untuk mengakses data selalu diberikan secara eksplisit oleh pengguna. Untuk informasi selengkapnya, lihat Ringkasan Izin.

Otorisasi ditangani oleh protokol OAuth 2.0. Saat pengguna setuju untuk memberikan akses ke tingkat izin yang diminta, Nest mengautentikasi permintaan dan token akses diberikan kepada pemohon. Token akses tersebut dapat digunakan untuk mengakses Nest API dan berinteraksi dengan struktur dan perangkat pengguna.

Dengan memberikan token akses, Anda akan menjalin hubungan kepercayaan antara pengguna, produk Works with Nest, dan Nest. Pengguna dapat mencabut akses kapan saja.

Untuk mempelajari cara memberi otorisasi koneksi ke Nest API, lihat Ringkasan Otorisasi.