Hạn mức bảo vệ cơ sở hạ tầng của Google khỏi các quy trình tự động sử dụng Campaign Manager 360 API theo cách không phù hợp. Các quy tắc 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ả các tài nguyên và phương thức Campaign Manager 360 API đều dùng chung các hạn mức mặc định sau đây.
- 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, hạn mức này được gọi là Số lượng truy vấn mỗi phút cho 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 khi cần, tối đa là 600 (10 QPS).
Trình tạo báo cáo áp dụng các hạn mức bổ sung khác nhau theo từng tài khoản. Để tìm hiểu thêm, hãy tham khảo bài viết này trên 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 là 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, phần nội dung của phản hồi còn có 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 yêu cầu không thành công do vượt quá hạn mức.
| Mã | Lý do | Nhắn tin | Việc nên làm |
|---|---|---|---|
| 403 | dailyLimitExceeded | Vượt quá hạn mức hằng ngày | Đừng thử lại mà không khắc phục vấn đề. Kiểm tra mức sử dụng trong Google API Console và sửa đổi quy trình làm việc để giảm số lượng yêu cầu. Bạn có thể yêu cầu hạn mức bổ sung 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 cố gắng chạy thêm báo cáo nào cho tài khoản này trong 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ố gắng chạy thêm báo cáo nào cho hồ sơ người dùng này trong ngày hôm nay. 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ủa bạ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 những 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 vô hiệu hoá những báo cáo định kỳ mà họ không cầ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 những 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 cho mỗi người dùng trong Bảng điều khiển API của Google hoặc giảm tốc độ gửi yêu cầu bằng cách sử dụng thuật toán thời gian chờ luỹ tiến. Bạn không nên thực hiện 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 hạn mức bổ sung hằng ngày
Nếu cho rằng ứng dụng của mình cần hạn mức hằng ngày bổ sung, bạn có thể yêu cầu thêm bằng cách làm theo hướng dẫn bên dưới.
Các hướng dẫn sau đây chỉ áp dụng cho những dự án gặp phải lỗi dailyLimitExceeded. Các hành động được đề xuất cho những lỗi khác liên quan đến hạn mức được trình bày trong bảng ở trên.
- Chuyển đến Campaign Manager 360 API trong Google API Console.
- Xem 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 những 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ố lượng 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 kỹ 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.