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.

Kết cấu

cấu trúc

Cấu trúc tổ đại diện cho cấu trúc vật lý trong thế giới thực. Điển hình là nhà của người dùng, chúng đóng vai trò như một điểm sắp xếp cho các thiết bị và sẽ lưu trữ dữ liệu áp dụng cho toàn bộ ngôi nhà.

Các API Nest cung cấp quyền truy cập vào dữ liệu cấu trúc cấp sau, phụ thuộc vào mức độ quyền được cấp:

  • Tên cấu trúc và thiết bị "tên ở đâu" (vị trí trong nhà)
  • Danh sách các thiết bị trong nhà
  • Tình trạng kiện năng lượng ( năng lượng giờ cao điểm )
  • Trạng thái đi vắng
  • Người dùng ETA
  • Tình trạng an ninh
  • Mã bưu điện hoặc mã zip

Một số tính năng cấp cấu trúc được đề cập trong các hướng dẫn API riêng biệt, chi tiết hơn:

Quyền cấu trúc

Để truy cập vào ... Lựa chọn...
Hầu hết các giá trị dữ liệu trong structures đối tượng Đi , ETA , Năng lượng , hoặc Mã bưu điện cho phép
Các name giá trị dữ liệu trong structures đối tượng Cấu trúc đọc / ghi cho phép

Xem cách cho phép làm việc trong tham chiếu API tương tác .

Định danh cấu trúc

Tên

Tên của cấu trúc được mặc định là "Trang chủ" nhưng có thể là bất kỳ chuỗi nào mà người dùng chọn. Khi bạn chọn Structure đọc / ghi cho phép, bạn có thể thay đổi cấu trúc name .

Bánh xe

wheres là một tập đối tượng trên một cấu trúc, bao gồm nơi định danh ( where_idname ). Sử dụng wheres để tạo ra tùy chỉnh nơi tên, hoặc truy cập chuẩn nơi tên.

Truy cập vào các wheres đối tượng đòi hỏi máy ảnh , khói + CO Alarm , hoặc điều chỉnh nhiệt cho phép.

where_id

  • Một độc đáo, định danh Nest tạo đại diện cho name
  • where_id là read-only, và được tạo ra tự động trong các cuộc gọi để tạo ra một phong tục nơi name

name

  • Tên hiển thị của thiết bị; có thể là bất kỳ tên phòng nào từ danh sách chúng tôi cung cấp hoặc tên tùy chỉnh
  • Để tạo một phong tục nơi name , thực hiện cuộc gọi POST để viết một mới, tùy chỉnh nơi name ; các where_id được trả lại trong cuộc gọi
  • Cân nhắc
    • name không thể chỉnh sửa hoặc xóa sau khi tạo
    • name phải là duy nhất trong cấu trúc
    • Nếu một thiết bị được ghép với một cấu trúc, phong tục nơi name gắn liền với các thiết bị có thể truy cập từ /structures/ đường
    • Để di chuyển một thiết bị với một phong tục nơi name vào một cấu trúc khác nhau, hủy ghép nối thiết bị, và sau đó tái ghép thiết bị với tên mong muốn

Tìm hiểu thêm về tên cho nhiệt Nest ,Nest Bảo vệNest Cams .

Siêu dữ liệu khác

Tất cả các giá trị dữ liệu chỉ được đọc, trừ khi được chỉ định khác.

Giá trị dữ liệu Sự miêu tả
structure_id Một chuỗi đại diện duy nhất cho cấu trúc này. Mọi nhà phát triển sẽ thấy một ID khác nhau cho cùng một cấu trúc, nhưng nhiều sản phẩm từ cùng một nhà phát triển sẽ thấy cùng một ID
country_code Mã quốc gia ISO 3166-1 alpha-2 ánh xạ tới vị trí đã đăng ký của cấu trúc
postal_code Mã bưu điện hoặc mã zip, tùy thuộc vào quốc gia
time_zone Một IANA múi giờ chuỗi mà các bản đồ để múi giờ của cấu trúc

Đặc điểm cấu trúc

Trạng thái cảnh báo khói và khí CO

Khi bạn chọn khói + CO quyền đọc , bạn có thể truy cập vào smoke_alarm_stateco_alarm_state trong structures đối tượng. Những giá trị dữ liệu tương tự cũng có sẵn trong các đối tượng thiết bị ( devices/smoke_co_alarms ).

Xem khói + hướng dẫn báo CO để biết thêm thông tin về các tiểu bang.

Nhiều giá trị dữ liệu hoạt động cùng nhau để xác định cách các thiết bị hoạt động trong một cấu trúc.

  • Khi một cấu trúc away nhà nước được thiết lập để away từ "ECO" được hiển thị trên Nest Thermostat, trong ngôn ngữ ưa thích của người dùng
  • Khi một cấu trúc away nhà nước được thiết lập để away , bạn có thể:
    • bộ fan_timer_active
    • thay đổi target_temperature_f hoặc target_temperature_c
  • Khi một cấu trúc away nhà nước được thiết lập để home , bạn có thể:
    • thực hiện cuộc gọi ETA (đặt id chuyến đi và cửa sổ đến)
  • Khi khẩn cấp ngắt được kích hoạt, bạn không thể đặt fan_timer_active
  • Khi khẩn cấp nhiệt được kích hoạt, bạn có thể không thể thiết lập cấu trúc để away

Nhiều cấu trúc

Có thể người dùng có nhiều cấu trúc được gắn với Tài khoản Nest của họ, vì vậy, sản phẩm của bạn phải cung cấp phương tiện để người dùng lựa chọn trong số các cấu trúc có sẵn (công cụ chọn cấu trúc).

Bộ chọn cấu trúc

Ví dụ: khi thiết lập ETA, điều quan trọng là người dùng có thể chọn cấu trúc cho điểm đến ETA. Theo cách tương tự, một người dùng có thể có hai thiết bị phát hiện khói trong "phòng khách" của hai ngôi nhà khác nhau. Nếu bạn cần làm tương quan cấu trúc với khái niệm của riêng bạn về một ngôi nhà, chúng tôi khuyên bạn nên làm điều này trong quá trình ủy quyền.

Tìm hiểu cách người dùng quản lý các thiết bị trong nhiều cấu trúc .

Mức tối đa của thiết bị

Có giới hạn về số lượng thiết bị mà Nest hỗ trợ trong một cấu trúc.

Loại thiết bị Tối đa mỗi cấu trúc
Nest Thermostat 20
Máy ảnh Nest 10
Nest Protect 18

Thông báo lỗi

Để biết thông tin về những gì lỗi gọi API nghĩa và cách xử lý chúng, hãy xem thông báo lỗi .