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

Arsitektur API Sarang

Tentang layanan Nest

Aplikasi Nest memungkinkan pengguna untuk terhubung dengan rumah mereka dari mana pun mereka berada. Semua perangkat Nest (Termostat, Proteksi, 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.

Sebagai contoh, termostat membaca suhu targetnya dari model data. Ini mengatur suhu sekitar ke pengukuran saat ini, dan mengirimkan data sensor ke Home / Away Assist, yang menyesuaikan mode struktur sesuai.

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

Model data

Nest API direpresentasikan sebagai dokumen JSON dengan atribut tingkat atas metadata , devices , dan structures . Karya Anda dengan produk Nest menggunakan dokumen JSON ini untuk berinteraksi dengan, dan bereaksi terhadap, perangkat Nest dan perubahan status terkait.

structures sarang mewakili structures fisik di dunia nyata. Mereka berfungsi sebagai titik pengorganisasian untuk devices dan menyimpan data untuk bangunan secara keseluruhan. Biasanya, structure adalah rumah pengguna.

devices Nest mewakili devices fisik (Thermostat, Proteksi, dan Kamera) dalam suatu struktur.

Setiap elemen data dalam dokumen JSON dapat dialamatkan dengan URL (juga dikenal sebagai "lokasi data"). Bekerja dengan produk Nest dapat membaca dan menulis ke bagian-bagian dokumen ini dan berlangganan perubahan. Kemampuan berlangganan ini memungkinkan produk Works with Nest bereaksi secara real time terhadap perubahan yang dilakukan pada sistem, seperti mematikan lampu saat pengguna mengatur struktur ke Jauh.

Objek juga bekerja di bawah batasan dunia nyata. Model data melindungi perangkat dan rumah pengguna dengan mencegah tindakan mengejutkan dan berbahaya. Misalnya, termostat tidak menjalankan AC ketika panas darurat diaktifkan.

Jelajahi model data dengan Referensi API interaktif ini.

Keadaan yang diinginkan

Layanan Nest menyimpan status otoritatif sistem, dan produk Works with Nest berlangganan perubahan. Mengubah kondisi ini (misalnya, untuk mengubah suhu target termostat) menyebabkan layanan mendorong pemberitahuan perubahan ke semua pelanggan.

Karena propagasi ini memiliki beberapa keterlambatan dan jaringan dapat tidak dapat diandalkan, keadaan yang diamati oleh suatu produk mungkin bukan keadaan yang saat ini diamati oleh produk atau layanan lain. Status akhirnya disinkronkan saat pesan dikirim antara berbagai produk.

Model publikasi / berlangganan berorientasi dokumen ini menyediakan interaksi aplikasi yang responsif.

Menggunakan layanan Nest

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

Izin dan otorisasi

Kami ingin memungkinkan pengembang membangun produk dan layanan yang membuat rumah menjadi 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 lebih lanjut, lihat Tinjauan Izin .

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

Memberi token akses membangun hubungan saling percaya antara pengguna, produk Works with Nest, dan Nest. Pengguna dapat mencabut akses kapan saja.

Untuk mempelajari cara mengotorisasi koneksi ke Nest API, lihat Ikhtisar Otorisasi .