Trang này liệt kê nhiều hạn mức và giới hạn dành riêng cho API Quản lý AdSense. Các giới hạn này cùng áp dụng cho mọi giới hạn dành riêng cho sản phẩm (chẳng hạn như số lượng kênh trên mỗi tài khoản) áp dụng cho AdSense nói chung.
Hạn mức cấp API
Tất cả các yêu cầu gửi đến API Quản lý AdSense đều được tính vào hạn mức tỷ lệ yêu cầu chung, không phụ thuộc vào loại yêu cầu.
Bạn có thể xem mức sử dụng hiện tại đối với bất kỳ hạn mức nào trong số này bằng cách sử dụng trang Hạn mức trong Bảng điều khiển API của Google. Bạn cũng có thể thiết lập tính năng cảnh báo mức sử dụng hoặc giám sát bổ sung. Hãy xem tài liệu chung về hạn mức của Google Cloud để biết thêm thông tin.
Việc vượt quá hạn mức này sẽ khiến yêu cầu bị từ chối và gặp lỗi HTTP 429 quá nhiều yêu cầu. Thông báo lỗi sẽ bao gồm chi tiết về việc vượt quá hạn mức.
| Nội dung mô tả | Giá trị | Ghi chú |
|---|---|---|
| Số truy vấn mỗi phút cho một người dùng và dự án | 100 | không áp dụng |
| Số truy vấn mỗi phút cho tất cả người dùng sử dụng một dự án duy nhất | 500 | không áp dụng |
| Số truy vấn mỗi ngày | 10.000 | Hạn mức hằng ngày sẽ được đặt lại vào khoảng nửa đêm theo giờ Thái Bình Dương. |
Giới hạn kích thước báo cáo
Báo cáo do API Quản lý AdSense tạo ra sẽ có kích thước tối đa phụ thuộc vào định dạng đầu ra:
-
Báo cáo JSON (ví dụ: được tạo bằng phương thức
accounts.reports.generate) bị giới hạn ở tối đa 100.000 hàng. Các báo cáo lớn hơn giá trị này sẽ bị cắt bớt. Tuy nhiên, phản hồi có trường
totalMatchedRowsbao gồm kích thước của báo cáo đầy đủ. Bạn có thể dùng trường này để xác định xem có bị cắt bớt hay không. - Báo cáo CSV (ví dụ: được tạo bằng phương thức accounts.reports.generateCsv) bị giới hạn ở tối đa 1.000.000 hàng. Báo cáo lớn hơn kích thước này sẽ bị cắt bớt.
Báo cáo hạn mức hàng
API Quản lý AdSense cũng áp dụng các giới hạn cho tổng lượng dữ liệu báo cáo có thể được truy xuất trong khoảng thời gian ngắn hơn và hằng ngày để ngăn chặn hành vi sử dụng sai mục đích. Việc vượt quá giới hạn này sẽ khiến yêu cầu bị từ chối kèm theo lỗi Quá nhiều yêu cầu HTTP 429 cùng với thông báo liên kết "Báo cáo đã vượt quá hạn mức hàng".
Các hạn mức khác về yêu cầu
Nhiều tham số yêu cầu kiểm soát lượng dữ liệu cần được trả về cho một yêu cầu (ví dụ: page_size đối với các yêu cầu cho phép phân trang hoặc tham số limit đối với các yêu cầu tạo báo cáo). Nếu bạn không chỉ định các tham số này, giá trị mặc định sẽ luôn là giá trị tối đa được cho phép. Việc chỉ định một giá trị cao hơn sẽ khiến yêu cầu bị từ chối kèm theo lỗi Yêu cầu không hợp lệ HTTP 400.