Giới hạn và hạn mức

Hãy làm theo hướng dẫn này để hiểu rõ các giới hạn và hạn mức khi sử dụng Data Manager API.

Hạn mức về dự án

Bạn cần có một dự án trên đám mây của Google Cloud để sử dụng Data Manager API. Dự án trên đám mây của Google Cloud cung cấp ứng dụng OAuth và thông tin đăng nhập mà bạn dùng để xác thực các yêu cầu API.

Data Manager API áp dụng hạn mức cho từng dự án Google Cloud, được phân tách theo dịch vụ và loại thao tác (đọc so với thay đổi):

Dịch vụ Hoạt động Số yêu cầu mỗi ngày Số yêu cầu mỗi phút
IngestionService Thay đổi (ghi) 100.000 300
IngestionService Đọc 100.000 300
Tất cả các dịch vụ khác kết hợp Thay đổi (ghi) 50.000 300
Tất cả các dịch vụ khác kết hợp Đọc 50.000 300

Những yêu cầu vượt quá hạn mức sẽ bị từ chối kèm theo lỗi RESOURCE_EXHAUSTED và trạng thái HTTP 429 Too Many Requests.

Bạn có thể kiểm soát ứng dụng và giảm thiểu hạn mức bằng cách chủ động giảm số lượng yêu cầu và điều chỉnh QPS từ phía máy khách. Bạn cũng có thể thiết lập cảnh báo và hoạt động giám sát hạn mức trong Google Cloud Console để nhận thông báo trước khi ứng dụng đạt đến hạn mức.

Tên hạn mức

Mỗi giới hạn tương ứng với một tên và chỉ số giới hạn hạn mức trong Google Cloud. Khi một yêu cầu vượt quá hạn mức, Data Manager API sẽ trả về tên hạn mức trong tải trọng chi tiết tiêu chuẩn ErrorInfo trong metadata.quota_limit:

Tên hạn mức Dịch vụ Hoạt động Cửa sổ Hạn mức
IngestionMutateRequestsPerDayPerProject IngestionService Thay đổi Ngày 100.000
IngestionMutateRequestsPerMinutePerProject IngestionService Thay đổi Phút 300
IngestionReadRequestsPerDayPerProject IngestionService Đọc Ngày 100.000
IngestionReadRequestsPerMinutePerProject IngestionService Đọc Phút 300
ManagementMutateRequestsPerDayPerProject Tất cả dịch vụ khác Thay đổi Ngày 50.000
ManagementMutateRequestsPerMinutePerProject Tất cả dịch vụ khác Thay đổi Phút 300
ManagementReadRequestsPerDayPerProject Tất cả dịch vụ khác Đọc Ngày 50.000
ManagementReadRequestsPerMinutePerProject Tất cả dịch vụ khác Đọc Phút 300

Kiểm tra metadata.quota_limit trong tải trọng ErrorInfo để phân biệt giữa lỗi giới hạn hằng ngày và lỗi giới hạn theo phút, đồng thời xác định xem có nên tạm dừng và thử lại với độ trễ hay tạm dừng cho đến khi hạn mức hằng ngày được đặt lại. Để biết thông tin chi tiết, hãy xem bài viết Lỗi hạn mức và giới hạn tốc độ.

Giới hạn yêu cầu

Sau đây là các giới hạn đối với những yêu cầu cụ thể:

  • IngestAudienceMembersRequest và RemoveAudienceMembersRequest:

    • 10.000 tài nguyên AudienceMember trong danh sách audience_members

    • 10 giá trị nhận dạng người dùng trong UserData cho một AudienceMember

    • 10 Destination tài nguyên trong danh sách destinations

  • RemoveAllAudienceMembersRequest:

    • 10 Destination tài nguyên trong danh sách destinations

  • IngestEventsRequest:

    • 2.000 tài nguyên Event trong danh sách events

    • 10 giá trị nhận dạng người dùng trong UserData cho một Event

    • 10 Destination tài nguyên trong danh sách destinations