Notice: We're retiring Works with Nest. See the home page for more information.
Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Kiến trúc của API Nest

Về dịch vụ Nest

Các ứng dụng Nest cho phép người dùng kết nối với nhà của họ từ bất cứ nơi nào họ có thể. Tất cả các thiết bị Nest (Thermostats, Protects và Camera) và các ứng dụng (iOS, Android và ứng dụng web) kết nối với dịch vụ Nest.

Ví dụ đám mây

Dịch vụ Nest cung cấp một mô hình dữ liệu của ngôi nhà. Các thiết bị và ứng dụng đọc từ mô hình dữ liệu này để có hành động thích hợp. Họ cập nhật mô hình dữ liệu để phản ánh những thay đổi trong hệ thống.

Ví dụ, một bộ điều nhiệt đọc nhiệt độ mục tiêu của nó từ mô hình dữ liệu. Nó đặt nhiệt độ môi trường xung quanh phép đo hiện tại của nó và gửi dữ liệu cảm biến đến Home / Away Assistant, điều chỉnh chế độ cấu trúc phù hợp.

Các thiết bị Nest hoạt động trong môi trường hạn chế. Nguồn điện bị hạn chế và kết nối mạng gia đình có thể không đáng tin cậy. Các sản phẩm và dịch vụ của bạn có thể tận dụng các thuật toán thiết bị của chúng tôi để cung cấp cho người dùng trải nghiệm tại nhà đơn giản, trực quan.

Mô hình dữ liệu

API Nest được biểu diễn dưới dạng tài liệu JSON với các thuộc tính cấp cao nhất của metadata , devicesstructures . Các tác phẩm của bạn với các sản phẩm Nest sử dụng tài liệu JSON này để tương tác và phản ứng với các thiết bị Nest và các thay đổi trạng thái liên quan.

structures đại diện cho structures vật lý trong thế giới thực. Chúng phục vụ như một điểm tổ chức cho devices và lưu trữ dữ liệu cho toàn bộ tòa nhà. Thông thường, một structure là một ngôi nhà người dùng.

Các devices Nest đại diện cho các thiết bị vật lý (Thermostats, Protects và Camera) trong một cấu trúc.

Mọi yếu tố dữ liệu trong tài liệu JSON đều có thể truy cập được bằng URL (còn được gọi là "vị trí dữ liệu"). Hoạt động với các sản phẩm Nest có thể đọc và ghi vào các phần của tài liệu này và đăng ký thay đổi. Khả năng đăng ký này cho phép các sản phẩm của Nest hoạt động theo thời gian thực với các thay đổi được thực hiện cho hệ thống, chẳng hạn như tắt đèn khi người dùng đặt cấu trúc thành Away.

Các đối tượng cũng làm việc dưới những ràng buộc trong thế giới thực. Mô hình dữ liệu bảo vệ các thiết bị và nhà của người dùng bằng cách ngăn chặn các hành động đáng ngạc nhiên và nguy hiểm. Ví dụ, bộ điều chỉnh nhiệt không chạy điều hòa khi bật nhiệt khẩn cấp.

Khám phá mô hình dữ liệu với Tham chiếu API tương tác này.

Nhà nước dự định

Dịch vụ Nest lưu trữ trạng thái có thẩm quyền của hệ thống và Hoạt động với các sản phẩm của Nest đăng ký thay đổi. Sửa đổi trạng thái này (ví dụ: để thay đổi nhiệt độ mục tiêu của bộ điều nhiệt) khiến dịch vụ đẩy thông báo thay đổi tới tất cả các thuê bao.

Vì sự lan truyền này có một số độ trễ và mạng có thể không đáng tin cậy, trạng thái được quan sát bởi một sản phẩm có thể không phải là trạng thái hiện được quan sát bởi các sản phẩm hoặc dịch vụ khác. Trạng thái cuối cùng được đồng bộ hóa khi các thông điệp được truyền giữa các sản phẩm khác nhau.

Mô hình xuất bản / đăng ký theo định hướng tài liệu này cung cấp các tương tác ứng dụng đáp ứng.

Sử dụng dịch vụ Nest

Để truy cập các điểm cuối REST trong dịch vụ Nest, hãy sử dụng HTTPS trong sản phẩm của bạn. Có nhiều thư viện khách của bên thứ ba có thể được sử dụng cho mục đích này.

Quyền và ủy quyền

Chúng tôi muốn cho phép các nhà phát triển xây dựng các sản phẩm và dịch vụ làm cho ngôi nhà tốt hơn mà không ảnh hưởng đến quyền riêng tư và bảo mật của người dùng. Tất cả các thông tin liên lạc của chúng tôi đều được bảo mật và quyền truy cập dữ liệu luôn được người dùng cấp rõ ràng. Để biết thêm thông tin, xem Tổng quan về Quyền .

Việc ủy ​​quyền được xử lý bởi giao thức OAuth 2.0. Khi người dùng đồng ý cung cấp quyền truy cập vào mức cấp phép được yêu cầu, Nest xác thực yêu cầu và mã thông báo truy cập được cấp cho người yêu cầu. Mã thông báo truy cập đó có thể được sử dụng để truy cập Nest API và tương tác với các cấu trúc và thiết bị của người dùng.

Cấp mã thông báo truy cập sẽ thiết lập mối quan hệ tin cậy giữa người dùng, sản phẩm Hoạt động với sản phẩm Nest và Nest. Người dùng có thể thu hồi quyền truy cập bất cứ lúc nào.

Để tìm hiểu cách ủy quyền kết nối với API Nest, hãy xem Tổng quan về ủy quyền .