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 Nest API

Tentang layanan Nest

Aplikasi Nest memungkinkan pengguna terhubung dengan rumah mereka dari mana pun mereka berada. Semua perangkat Nest (Termostat, Perlindungan, 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. Ini mengatur suhu sekitar ke pengukurannya saat ini, dan mengirim data sensor ke Bantuan Rumah / Tandang, yang menyesuaikan mode strukturnya.

Perangkat Nest beroperasi di lingkungan terbatas. Daya terbatas dan konektivitas jaringan rumah mungkin 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 . Produk Works with Nest Anda menggunakan dokumen JSON ini untuk berinteraksi dengan, dan bereaksi terhadap, perangkat Nest dan perubahan status terkait.

structures sarang merepresentasikan 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 (Termostat, Perlindungan, dan Kamera) dalam suatu struktur.

Setiap elemen data dalam dokumen JSON dapat dialamatkan oleh URL (juga dikenal sebagai "lokasi data"). Produk Works with Nest dapat membaca dan menulis ke bagian dari dokumen ini dan mengikuti perubahan. Kemampuan langganan ini memungkinkan produk Works with Nest bereaksi secara real time terhadap perubahan yang dilakukan pada sistem, seperti mematikan lampu saat pengguna menyetel 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 saat pemanas darurat diaktifkan.

Jelajahi model data dengan Referensi API interaktif ini.

Keadaan yang diinginkan

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

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

Model publikasi / langganan 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 mengizinkan pengembang untuk membuat 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 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 tersebut dan token akses diberikan kepada pemohon. Token akses tersebut dapat digunakan untuk mengakses Nest API dan berinteraksi dengan struktur dan perangkat pengguna.

Pemberian token akses membentuk 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 .