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

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, họ đóng vai trò là điểm tổ chức cho các thiết bị và sẽ lưu trữ dữ liệu áp dụng cho toàn bộ ngôi nhà.

API Nest cung cấp quyền truy cập vào dữ liệu cấp cấu trúc sau, tùy thuộc vào cấp quyền được cấp:

  • Tên cấu trúc và thiết bị "nơi tên" (vị trí trong nhà)
  • Danh sách các thiết bị trong nhà
  • Tình trạng sự kiện năng lượng ( giờ cao điểm năng lượng )
  • Nhà nước xa
  • ETA người dùng
  • Nhà nước 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 trình bày trong các hướng dẫn API chi tiết, riêng biệ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 đối tượng structures Giấy phép đi xa , ETA , Năng lượng hoặc Mã bưu chính
Giá trị dữ liệu name trong đối tượng structures Cấu trúc cho phép đọc / ghi

Xem cách các quyền hoạt động 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 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 quyền đọc / ghi cấu trúc , bạn có thể thay đổi name cấu trúc.

Nơi nào

wheres là một đối tượng được đặt trên một cấu trúc, chứa 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 định danh duy nhất, do Nest tạo ra đại diện cho name
  • where_id ở chế độ chỉ đọc và được tạo tự động trong cuộc gọi để tạo một name tùy chỉnh

name

  • Tên hiển thị của thiết bị; có thể là bất kỳ tên phòng nào trong 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 ; where_id được trả lại trong cuộc gọi
  • Cân nhắc
    • name không thể được 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 nối với một cấu trúc, thì tùy chỉnh nơi name liên kết với thiết bị có thể truy cập được từ /structures/ đường dẫn
    • Để di chuyển thiết bị có name tùy chỉnh sang một cấu trúc khác, hủy ghép nối thiết bị và sau đó ghép lại thiết bị với tên mong muốn

Tìm hiểu thêm về tên của Nest Thermostats , Nest ProtectsNest Cam .

Siêu dữ liệu khác

Tất cả các giá trị dữ liệu chỉ được đọc, trừ khi có quy đị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 Chuỗi múi giờ IANA ánh xạ tới múi giờ của cấu trúc

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

Trạng thái báo động khói và CO

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

Xem hướng dẫn báo động khói + CO để biết thêm thông tin về các trạng thái này.

Nhiều giá trị dữ liệu phối hợp với 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 trạng thái cấu trúc away được đặt thành away , bạn có thể:
    • đặt 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 Tắt khẩn cấp được kích hoạt, bạn không thể đặt fan_timer_active
  • Khi Nhiệt khẩn cấp được bật, bạn không thể đặt 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 đính kèm với Tài khoản Nest của họ, vì vậy sản phẩm của bạn nên cung cấp phương tiện để người dùng chọn từ các cấu trúc có sẵn (bộ chọn cấu trúc).

Công cụ 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 đích ETA. Theo cách tương tự, một người dùng có thể có hai máy dò khói trong "phòng khách" của hai ngôi nhà khác nhau. Nếu bạn cần thực hiện tương quan cấu trúc với khái niệm nhà riêng của bạn, 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ý thiết bị trong nhiều cấu trúc .

Tối đa thiết bị

Có giới hạn đối với 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 trên mỗi cấu trúc
Nest nhiệt 20
Máy ảnh Nest 10
Yến bảo vệ 18

Thông báo lỗi

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