Giới hạn người dùng và giá

Device Access Các dự án bị hạn chế theo người dùng, cấu trúc và giới hạn về số lượng yêu cầu, tuỳ thuộc vào môi trường và loại Sản phẩm thương mại.

Chúng tôi muốn nhà phát triển tạo ra trải nghiệm người dùng hấp dẫn, nhưng chúng tôi cũng muốn người dùng luôn sử dụng được dịch vụ và thiết bị Nest. Các chế độ tích hợp đưa ra số lượng yêu cầu lớn trong một khoảng thời gian nhất định có thể ảnh hưởng đến khả năng sử dụng dịch vụ và thiết bị, vì vậy, API SDM áp dụng giới hạn số lượng yêu cầu. Giới hạn số lượng lệnh gọi API trong một khoảng thời gian nhất định và ngăn chặn việc sử dụng tài nguyên quá mức.

Giới hạn theo môi trường

Tất cả dự án đều bắt đầu trong môi trường   Sandbox  . Hộp cát dùng để đánh giá API SDM và mục đích sử dụng cá nhân, đồng thời các giới hạn được hạn chế tương ứng. Các môi trường có cơ sở người dùng lớn hơn, chẳng hạn như   Phát triển thương mại  , sẽ có các giới hạn khác nhau.

Giới hạn người dùng hộp cát

Một tài khoản nhà phát triển trong Hộp cát chỉ được có tối đa 25 người dùng trên 5 cấu trúc của tất cả các dự án. Mỗi tài khoản chỉ được có tối đa 3 dự án.

Mỗi cấu trúc chỉ có tối đa 5 người dùng. Vì vậy, bạn sẽ chỉ đạt đến giới hạn người dùng sau khi cả 5 cấu trúc đạt hiệu suất tối đa với 5 người dùng cho mỗi cấu trúc. Tài khoản nhà phát triển (sở hữu dự án) không được tính vào giới hạn 5 người dùng cho một cấu trúc.

Ngược lại, nếu một dự án có 15 người dùng trên 5 cấu trúc, thì bạn chỉ có thể thêm người dùng bổ sung vào 5 cấu trúc hiện có vì đã đạt đến giới hạn cấu trúc.

Giới hạn số lượng hộp cát

Hộp cát bị giới hạn tốc độ ở 3 cấp độ khác nhau. Giới hạn được đặt ở mức truy vấn mỗi phút (QPM) trừ khi có ghi chú khác.

Cấp độ API

Lệnh gọi API bị giới hạn cho mỗi dự án, mỗi người dùng. Hãy xem Tài liệu tham khảo API để biết thêm thông tin về các phương thức riêng lẻ.

Phương thức API Giới hạn tốc độ
devices.executeCommand 10 QPM
devices.get 10 QPM
devices.list 5 QPM
structures.get 5 QPM
structures.list 5 QPM
structures.rooms.get 5 QPM
structures.rooms.list 5 QPM

Cấp lệnh

Mỗi lệnh trait (devices.executeCommand) được giới hạn ở 5 QPM cho mỗi dự án, mỗi người dùng và thiết bị.

Điều đó có nghĩa là nếu một dự án có 2 người dùng với mỗi thiết bị có 2 thiết bị (tổng cộng 4 thiết bị), cùng một lệnh có thể được gọi 5 lần trong một phút cho mỗi thiết bị trong số 4 thiết bị đó.

Tuy nhiên, nếu một dự án có 2 người dùng, mỗi người dùng có 3 thiết bị cho tổng cộng 6 thiết bị, thì cùng một lệnh có thể không được gọi 5 lần trong một phút cho mỗi thiết bị trong số 6 thiết bị đó. Điều này sẽ tạo ra 15 QPM cho mỗi người dùng khi giới hạn tốc độ cấp độ API devices.executeCommand cho người dùng dự án là 10 QPM.

Cấp phiên bản thiết bị

Ngoài ra, các giới hạn ở cấp thực thể thiết bị sẽ được triển khai trong các dự án và lệnh (devices.executeCommand) để bảo vệ pin của thiết bị. Các giới hạn này được áp dụng ở cả cấp độ QPM lẫn cấp truy vấn mỗi giờ (QPH), đồng thời không áp dụng cho các phương thức API get và list.

Ví dụ: giả sử cả Dự án A và Dự án B đều có quyền truy cập vào cùng một thiết bị là Thiết bị A (có thể người dùng đã uỷ quyền cho 2 quá trình tích hợp thương mại khác nhau sử dụng cùng một thiết bị). Nếu Dự án A đã gửi 4 lệnh đến Thiết bị A trong vòng một phút, thì Dự án B chỉ có thể gửi 1 lệnh đến Thiết bị A trong đúng phút đó trước khi đạt giới hạn tốc độ ở cấp thực thể của thiết bị. Tại thời điểm đó, các lệnh từ cả hai Dự án đến Thiết bị A sẽ được điều tiết cho đến cuối phút bắt đầu bằng lệnh đầu tiên đến Thiết bị A.

Nếu một loại thiết bị không có trong danh sách bên dưới thì loại thiết bị đó không có giới hạn số lượng yêu cầu ở cấp thực thể của thiết bị.

Loại thiết bị Giới hạn tốc độ phiên bản thiết bị
MÁY ĐIỀU NHIỆT 5 QPM hoặc 100 QPH
MÁY ẢNH 30 QPM hoặc 100 QPH
CHUÔNG CỬA 30 QPM hoặc 100 QPH

Lỗi

Liên quan đến hướng dẫn này, có thể trả về(các) mã lỗi sau:

Thông báo lỗi RPC Khắc phục sự cố
Mức giới hạn. RESOURCE_EXHAUSTED Mỗi nhà phát triển có một hạn mức giới hạn số lệnh gọi họ có thể thực hiện. Nếu thực hiện nhiều cuộc gọi hơn hạn mức của mình, bạn sẽ nhận được thông báo Giới hạn tốc độ. Để khắc phục vấn đề này, hãy gửi lại cuộc gọi sau khi hết hạn mức.

Hãy xem Tài liệu tham khảo về mã lỗi API để biết danh sách đầy đủ các mã lỗi API.