Google cam kết thúc đẩy công bằng chủng tộc cho các cộng đồng Đen. Xem thế nào.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Tham chiếu API Nest

Nest API mô hình hóa một ngôi nhà hoặc tòa nhà vật lý như một cấu trúc, với Bộ điều nhiệt Nest Learning, Nest Protects 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 Away hoặc ETA hoặc Rush Hour hoạt động).

Mọi thành phần dữ liệu trong cấu trúc đều có thể truy cập được bằng 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ố, booleans, đố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 sức khỏe của pin)

Sản phẩm của bạn nên phản hồi chu đáo với 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 chỉnh nhiệt không nên chạy điều hòa khi bật nhiệt khẩn cấp. API của chúng tôi được thiết kế để bảo vệ an toàn cho cả thiết bị của chúng tôi và nhà của người dùng và sẽ ngăn chặn một số hành động nhất định nếu chúng gây ngạc nhiên 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 được chọn trong các thiết bị và cấu trúc.

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

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

Các dữ liệu liên quan đến các sản phẩm gia đình 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 trong không gian cá nhân của họ. Bảo mật và xử lý dữ liệu đó là rất quan trọng và là trọng tâm quan trọng tại Nest. Chúng tôi làm cho nó rõ ràng cho người dùng loại dữ liệu chúng tôi có, cách sử dụng và nơi họ có thể kiểm soát dữ liệ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 gốc:

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 cuộc gọi API đến 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 thực hiện cuộc gọi thay mặt họ.

Chi tiết
Trả về string
Ví dụ: "c.FmDPkzyzaQe ..."

client_version

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

Khi bạn cập nhật quyền cho máy khách, phiên bản máy 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 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 cập nhật của bạn.

Chi tiết
Trả về 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. Mã định danh này khác nhau cho mỗi Tác phẩm với sản phẩm 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ó giá trị user_id khác cho người dùng 1.

Chi tiết
Trả về string
Ví dụ: z.1.1.7DHps ...