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.

Tài liệu tham khảo về Nest API

API Nest mô phỏng cấu trúc của một ngôi nhà hoặc tòa nhà thực tế, trong đó Nest Thermostat Thermostat, Nest Protects và Nest Cams làm 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 Vắng nhà hoặc ETA hoặc Giờ cao điểm đang hoạt động).

Mọi thành phần dữ liệu trong cấu trúc đều có thể xử lý bằng URL tài nguyên (gọi là &"data locations") trong một 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 mẹ/con hoặc mảng.

Khám phá mô hình dữ liệu này thông qua Tài liệu tham khảo 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ả thiết bị
  • một thiết bị duy nhất trong một cấu trúc
  • một nhóm giá trị dữ liệu (nhiệt độ hiện tại và nhiệt độ môi trường xung quanh)
  • một giá trị dữ liệu duy nhất (trạng thái pin)

Sản phẩm của bạn cần phải phản hồi chu đáo đối với các sự kiện như sau:

Tuy nhiên, xin lưu ý rằng mỗi đối tượng dựa trên thiết bị đều hoạt động trong các hạn chế trong thực tế. Ví dụ: máy điều nhiệt không nên chạy máy điều hòa khi bật chế độ sưởi ấm 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à riêng của người dùng, đồng thời sẽ ngăn chặn một số thao tác nếu chúng gây bất ngờ hoặc nguy hiểm.

Quyền và dữ liệu thiết bị dùng chung

Quyền đọc hoặc ghi vào vị trí dữ liệu chịu sự kiểm soát của quyền. Các nhóm quyền 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 bài viết 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 trong nhà có thể rất cá nhân. Dữ liệu cảm biến tại nhà chứa thông tin về cách mọi người sống cuộc sống của mình trong không gian cá nhân. Bảo mật và xử lý dữ liệu đó là rất quan trọng và là một tập trung đáng kể tại Nest. Chúng tôi làm rõ thông tin cho người dùng về loại dữ liệu chúng tôi có, cách dữ liệu được sử dụng và nơi họ có thể kiểm soát dữ liệu.

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

Siêu dữ liệu

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

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

access_token

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

Thông tin chi tiết
Trả vềstring
Ví dụ: "c.FmDPkzyzaQe..."

client_version

Phiên bản ứng dụng là phiên bản ứng dụng được người dùng ủy quyền gần đây nhất và được liên kết với một access_token.

Khi bạn cập nhật quyền cho ứng dụng, phiên bản ứng dụng sẽ tăng lên và người dùng nhận đượ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 này thì mới có thể sử dụng sản phẩm đã cập nhật.

Thông tin chi tiết
Trả vềnumber
Ví dụ: 1, 17, 42

user_id

Mã nhận dạng khách hàng cho phép bạn xác định người dùng trong các lệnh gọi API. Giá trị nhận dạng này sẽ khác nhau đối với từng kiểu kết hợp sản phẩm hoạt động với Nest.

Ví dụ: nếu người dùng 1 đã ủy quyền Sản phẩm Nest với sản phẩm Nest và Sản phẩm Nest với Sản phẩm 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.

Thông tin chi tiết
Trả vềstring
Ví dụ: z.1.1.7DHps...