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

Tham chiếu API Nest

API Nest lập mô hình một ngôi nhà hoặc tòa nhà vật lý dưới dạng cấu trúc, với Bộ điều nhiệt Nest Learning, Nest Protect và Nest Cam là các thiết bị trong cấu trúc. Cấu trúc này cũng chứa thông tin về toàn bộ ngôi nhà (chẳng hạn như trạng thái Đi vắng hoặc ETA, hoặc Giờ cao điểm đang hoạt động).

Mọi phần tử dữ liệu trong cấu trúc đều có thể được định địa chỉ bởi một URL tài nguyên (được gọi là "vị trí dữ liệu") trong tài liệu JSON được chia sẻ. Mỗi vị trí dữ liệu có thể lưu trữ chuỗi, số, boolean, đối tượng cha / con hoặc mảng.

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

Từ API, bạn có thể đồng bộ hóa dữ liệu từ các vị trí ở nhiều cấp trong mô hình dữ liệu, ví dụ:

  • toàn bộ cấu trúc, bao gồm tất cả các thiết bị
  • một thiết bị duy nhất trong một cấu trúc
  • một nhóm các giá trị dữ liệu (nhiệt độ hiện tại và môi trường xung quanh)
  • một giá trị dữ liệu duy nhất (trạng thái tình trạng pin)

Sản phẩm của bạn nên phản hồi một cách chu đáo cho các sự kiện như sau:

Tuy nhiên, hãy nhớ rằng mỗi đối tượng dựa trên thiết bị đang hoạt động dưới các ràng buộc trong thế giới thực. Ví dụ, bộ điều nhiệt không nên chạy máy điều hòa không khí khi bật nhiệt khẩn cấp. API của chúng tôi được thiết kế để bảo vệ cả thiết bị của chúng tôi và nhà của người dùng, đồng thời sẽ ngăn chặn một số hành động nếu chúng gây bất ngờ hoặc nguy hiểm.

Quyền và dữ liệu thiết bị được chia sẻ

Khả năng đọc hoặc ghi vào một vị trí dữ liệu được kiểm soát bởi các quyền. Các nhóm quyền cung cấp quyền truy cập đọc, ghi hoặc đọc / ghi vào các giá trị dữ liệu đã chọn trong các thiết bị và cấu trúc.

Để biết thêm thông tin, hãy xem Tổng quan về quyền .

Dữ liệu và quyền riêng tư

Dữ liệu liên quan đến các sản phẩm gia dụng có thể rất cá nhân. Dữ liệu cảm biến gia đình chứa thông tin về cách mọi người sống cuộc sống của họ trong không gian cá nhân của họ. Việc bảo mật và xử lý dữ liệu đó là rất quan trọng và là một trọng tâm đáng kể tại Nest. Chúng tôi làm rõ cho người dùng biết loại dữ liệu nào chúng tôi có, cách dữ liệu đó được sử dụng và họ có thể kiểm soát dữ liệu đó ở đâu.

Tìm hiểu thêm về quan điểm của chúng tôi về quyền riêng tư .

metadata

Siêu dữ liệu là thông tin bổ sung được cung cấp khi bạn thực hiện cuộc gọi đến điểm cuối cấp cơ sở:

https://developer-api.nest.com/

truy cập thẻ

Sau khi người dùng ủy quyền, sản phẩm của bạn sử dụng mã thông báo truy cập để thực hiện các lệnh gọi API tới dịch vụ Nest. Mã thông báo truy cập này đóng vai trò là bằng chứng cho thấy người dùng đã ủy quyền cho sản phẩm của bạn thay mặt họ thực hiện cuộc gọi.

Chi tiết
Lợi nhuận string
Ví dụ: "c.FmDPkzyzaQe ..."

client_version

Phiên bản ứng dụng khách là phiên bản được người dùng ủy quyền cuối cùng của ứng dụng khách và được liên kết với access_token .

Khi bạn cập nhật các quyền cho ứng dụng khách, phiên bản ứng dụng khách sẽ được tăng lên và người dùng được thông báo rằng có bản cập nhật. Người dùng của bạn phải chấp nhận bản cập nhật ứng dụng khách này trước khi họ có thể sử dụng sản phẩm đã cập nhật của bạn.

Chi tiết
Lợi nhuận number
Ví dụ: 1, 17, 42

tên người dùng

ID người dùng cho phép bạn xác định người dùng qua các lệnh gọi API. Số nhận dạng này khác nhau đối với từng sản phẩm Hoạt động với Nest và kết hợp người dùng.

Ví dụ: nếu người dùng 1 đã ủy quyền Hoạt động với sản phẩm Nest A và Hoạt động với sản phẩm Nest B, thì sản phẩm A có một giá trị user_id cho người dùng 1 và sản phẩm B có một giá trị user_id khác cho người dùng 1.

Chi tiết
Lợi nhuận string
Ví dụ: z.1.1.7DHps ...