Hạn mức giúp bảo vệ cơ sở hạ tầng của Google khỏi các quy trình tự động sử dụng API Campaign Manager 360 theo cách không phù hợp. Các biện pháp này đảm bảo rằng hành động của một nhà phát triển không thể ảnh hưởng tiêu cực đến cộng đồng lớn hơn.
Hạn mức
Tất cả tài nguyên và phương thức API của Campaign Manager 360 đều dùng chung các hạn mức hạn mức mặc định sau.
- 50.000 yêu cầu mỗi dự án mỗi ngày – có thể tăng.
- 1 truy vấn mỗi giây (QPS) cho mỗi dự án.
- Trong Google API Console, định mức này được gọi là Số truy vấn mỗi phút trên mỗi người dùng và được đặt thành 60 theo mặc định. Bạn có thể tăng hạn mức này nếu cần, tối đa là 600 (10 QPS).
Trình tạo báo cáo thực thi các hạn mức định mức bổ sung khác nhau tuỳ theo tài khoản. Để tìm hiểu thêm, hãy tham khảo bài viết này trong trung tâm trợ giúp và bảng bên dưới.
Vượt quá hạn mức
Trong trường hợp hiếm gặp yêu cầu của bạn không thành công do vượt quá hạn mức, API sẽ trả về mã trạng thái HTTP và lý do gây ra lỗi. Ngoài ra, nội dung của phản hồi chứa nội dung mô tả chi tiết về nguyên nhân gây ra lỗi. Hãy xem hướng dẫn về Thông báo lỗi để biết ví dụ về phản hồi lỗi.
Danh sách sau đây cho biết các lỗi có thể xảy ra và hành động được đề xuất đối với các lỗi yêu cầu do vượt quá hạn mức hạn mức.
| Mã | Lý do | Thông điệp | Việc nên làm |
|---|---|---|---|
| 403 | dailyLimitExceeded | Đã vượt quá giới hạn hằng ngày | Đừng thử lại nếu bạn chưa khắc phục vấn đề. Kiểm tra mức sử dụng của bạn trên Google API Console và sửa đổi quy trình làm việc để gửi ít yêu cầu hơn. Bạn có thể yêu cầu thêm hạn mức nếu cho rằng mức sử dụng của mình là hợp lý. |
| 403 | quotaExceeded | Tài khoản này đã vượt quá hạn mức x báo cáo mỗi ngày. | Đừng chạy thêm báo cáo nào cho tài khoản này vào ngày hôm nay. Hãy liên hệ với người quản lý tài khoản của bạn để được trợ giúp. |
| 403 | quotaExceeded | Hồ sơ người dùng này đã vượt quá hạn mức x báo cáo mỗi ngày. | Đừng cố chạy thêm báo cáo nào cho hồ sơ người dùng này vào ngày này. Chuyển sang một hồ sơ người dùng khác hoặc liên hệ với người quản lý tài khoản để được trợ giúp. |
| 403 | quotaExceeded | Tài khoản này đã vượt quá hạn mức x báo cáo được lập lịch đang hoạt động. | Huỷ kích hoạt các báo cáo định kỳ mà bạn không cần trước khi thử lại yêu cầu này. |
| 403 | quotaExceeded | Hồ sơ người dùng sở hữu báo cáo này đã vượt quá hạn mức x báo cáo được lập lịch đang hoạt động. | Yêu cầu chủ sở hữu báo cáo này huỷ kích hoạt các báo cáo định kỳ mà họ không cần đến trước khi thử lại yêu cầu này. |
| 403 | quotaExceeded | Hồ sơ người dùng này đã vượt quá hạn mức x báo cáo được lập lịch đang hoạt động. | Huỷ kích hoạt các báo cáo định kỳ mà bạn không cần trước khi thử lại yêu cầu này. |
| 403 | quotaExceeded | Không thể hoàn tất hành động này bởi vì một trong các hạn ngạch của bạn đã bị vượt quá. Vui lòng liên hệ với người quản lý tài khoản của bạn để được hỗ trợ. | Hãy liên hệ với người quản lý tài khoản của bạn để được trợ giúp. |
| 403 | userRateLimitExceeded | Đã vượt quá giới hạn tần suất của người dùng | Tăng giới hạn trên mỗi người dùng trong Google API Console hoặc giảm tốc độ gửi yêu cầu bằng cách sử dụng thời gian đợi luỹ thừa. Bạn không nên tạo các yêu cầu ghi đồng thời hoặc sử dụng giới hạn tốc độ cao hơn 10 QPS với API này. |
Yêu cầu tăng hạn mức hằng ngày
Nếu cho rằng ứng dụng của mình cần thêm hạn mức hằng ngày, bạn có thể yêu cầu tăng hạn mức bằng cách làm theo hướng dẫn bên dưới.
Hướng dẫn sau đây chỉ áp dụng cho các dự án gặp lỗi dailyLimitExceeded. Các hành động được đề xuất cho các lỗi hạn mức khác được đề cập trong bảng ở trên.
- Chuyển đến API Campaign Manager 360 trong Google API Console.
- Xem lại số liệu thống kê về mức sử dụng trên trang Chỉ số để đảm bảo ứng dụng của bạn hoạt động như mong đợi. Hãy chú ý đến các phương thức đã được gọi và giải quyết mọi trường hợp sử dụng không mong muốn hoặc quá mức trước khi tiếp tục.
- Nếu mức sử dụng có vẻ bình thường, hãy chuyển đến trang Hạn mức, nhấp vào biểu tượng chỉnh sửa bên cạnh Số truy vấn mỗi ngày rồi nhấp vào đường liên kết "Đăng ký hạn mức cao hơn".
Hãy nhớ xem lại thông tin và làm theo hướng dẫn trong biểu mẫu yêu cầu hạn mức trước khi gửi yêu cầu tăng hạn mức.