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

Giới thiệu 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 kỳ đâu. Tất cả các thiết bị Nest (Bộ điều nhiệt, Bảo vệ và Máy ảnh) và các ứng dụng (iOS, Android và ứng dụng web) đều kết nối với dịch vụ Nest.

Ví dụ từ đám mây đến đám mây

Dịch vụ Nest cung cấp 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 để thực hiện 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áy đ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 độ xung quanh thành phép đo hiện tại và gửi dữ liệu cảm biến đến Home / Away Assist, hệ thống này sẽ điều chỉnh chế độ cấu trúc cho 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 gia đình trực quan, đơn giản.

Mô hình dữ liệu

API Nest được biểu thị 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 sản phẩm Works with Nest của bạn 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 chất trong thế giới thực. Chúng đóng vai trò là đ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à của người dùng.

devices Nest đại diện cho các thiết bị vật lý (Bộ điều nhiệt, Bảo vệ và Máy ảnh) trong một cấu trúc.

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

Các đối tượng cũng hoạt động dưới các ràng buộc trong thế giới thực. Mô hình dữ liệu bảo vệ thiết bị và ngôi nhà của người dùng bằng cách ngăn chặn các hành động nguy hiểm và đáng ngạc nhiên. Ví dụ: bộ điều nhiệt không chạy máy điều hòa không khí 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.

Trạng thái dự định

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

Vì việc truyền bá 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 đăng ký / xuất bản theo 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 đ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 máy 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ụ giúp 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 vào dữ liệu luôn được người dùng cấp một cách rõ ràng. Để biết thêm thông tin, hãy 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 cấp độ quyền đượ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 API Nest và tương tác với các cấu trúc và thiết bị của người dùng.

Việc cấp mã thông báo truy cập 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 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 cấp phép kết nối với API Nest, hãy xem Tổng quan về ủy quyền .