Hạn mức và giới hạn của Nhà thông minh

Google Home giới hạn việc phân bổ và sử dụng tài nguyên, đồng thời thực thi hạn mức phù hợp theo từng dự án. Các chính sách cụ thể sẽ thay đổi tuỳ thuộc vào tình trạng sẵn có của tài nguyên, hồ sơ người dùng, nhật ký sử dụng dịch vụ và các yếu tố khác, đồng thời có thể thay đổi mà không cần thông báo.

Giới hạn của HomeGraph API

Phần này liệt kê các giới hạn về tốc độ cho Google Home Graph API. Các giới hạn này áp dụng cho cả API REST và RPC.

Google áp dụng hạn mức mặc định là 6.000 yêu cầu mỗi 60 giây cho tổng số lệnh gọi API truy vấn, đồng bộ hoá, xoá, Report State và tài nguyên không đồng bộ, trên cơ sở mỗi Cloud-to-cloud tích hợp.

Để yêu cầu tăng hạn mức, hãy liên hệ với ha-certification@google.com và cung cấp những thông tin sau:

  • Tiêu đề email: Yêu cầu tăng hạn mức API ReportState
  • Nội dung email:
    • Mã dự án
    • Tên công ty của bạn
    • Hạn mức hiện tại
    • Lý do bạn muốn tăng hạn mức
Hạn mức Hạn mức Có thể tăng lên
RequestSync (chế độ đồng bộ) Tối đa 1 yêu cầu đồng thời cho mỗi agentUserId. Không
RequestSync (chế độ không đồng bộ) Giới hạn mặc định là 6.000 yêu cầu mỗi 60 giây cho mỗi lần tích hợp Cloud-to-cloud. Có
Truy vấn Giới hạn mặc định là 6.000 yêu cầu mỗi 60 giây cho mỗi lần tích hợp Cloud-to-cloud. Có
Đồng bộ hoá Giới hạn mặc định là 6.000 yêu cầu mỗi 60 giây cho mỗi lần tích hợp Cloud-to-cloud. Có
Xoá Giới hạn mặc định là 6.000 yêu cầu mỗi 60 giây cho mỗi lần tích hợp Cloud-to-cloud. Có
ReportStateAndNotification Giới hạn mặc định là 6.000 yêu cầu mỗi 60 giây cho mỗi lần tích hợp Cloud-to-cloud. Có

Gỡ lỗi về hạn mức

Nếu quá trình tích hợp của bạn bị giới hạn tốc độ, hãy làm theo các nguyên tắc sau để chẩn đoán và giải quyết các vấn đề về hạn mức:

  1. Google sẽ giới hạn số lượng lệnh gọi API vượt quá hạn mức của bạn. Điều này ảnh hưởng tiêu cực đến quá trình tích hợp của bạn do gây ra tình trạng không khớp trạng thái. Ví dụ: nếu một yêu cầu ReportStateAndNotification bị loại bỏ do giới hạn tốc độ, thì trạng thái của thiết bị thực sẽ không đồng bộ hoá được, khiến Google Home app (GHA) có thông tin đã lỗi thời.

  2. Nếu RequestSync là API chính gặp lỗi, hãy kiểm tra để đảm bảo rằng dịch vụ của bạn không cố gắng thực hiện nhiều lệnh gọi đồng thời cho mỗi agentUserId.

  3. Xem xét mức tăng trưởng lưu lượng truy cập theo thời gian. Nếu mức tăng trưởng này phù hợp với mức tăng số lượng thiết bị, việc ra mắt một loại thiết bị mới hoặc một số hoạt động ra mắt dự kiến khác, hãy yêu cầu tăng hạn mức. Nếu mức tăng này là ngoài dự kiến, hãy xem lại quá trình tích hợp để xác định xem có phải một thay đổi ngoài dự kiến đang khiến lưu lượng truy cập được gửi đến Home Graph API tăng lên hay không.