GoogleAdsService.Search hỗ trợ phân trang theo kích thước trang cố định là 10.000 hàng. Tập hợp kết quả của truy vấn được chia thành nhiều phản hồi, mỗi phản hồi có 10.000 đối tượng.
Ví dụ: đối với truy vấn sau:
SELECT
ad_group.id,
ad_group_criterion.type,
ad_group_criterion.criterion_id,
ad_group_criterion.keyword.text,
ad_group_criterion.keyword.match_type
FROM ad_group_criterion
WHERE ad_group_criterion.type = KEYWORD
Nếu tài khoản của bạn chứa 50.000 từ khoá, tập hợp kết quả sẽ chứa 10.000 đối tượng GoogleAdsRow trong phản hồi đầu tiên, cùng với next_page_token.
Để truy xuất 10.000 hàng tiếp theo, hãy gửi lại yêu cầu, nhưng cập nhật page_token của yêu cầu thành next_page_token của phản hồi.
Xin lưu ý rằng next_page_token không được điền sẵn trong phản hồi chứa lô hàng cuối cùng.
Thư viện ứng dụng của chúng tôi tự động xử lý việc phân trang. Bạn chỉ cần lặp lại qua các hàng của phản hồi. Khi tất cả các hàng trong trang hiện tại đã được trả về, thư viện ứng dụng sẽ tự động thay mặt bạn tìm nạp một trang hàng mới cho đến khi truy xuất toàn bộ tập dữ liệu. Nếu sử dụng REST thay vì gRPC, bạn phải tạo một yêu cầu rõ ràng cho mỗi trang mới.
API Google Ads lưu toàn bộ tập dữ liệu vào bộ nhớ đệm nội bộ, vì vậy, các yêu cầu tiếp theo sẽ nhanh hơn yêu cầu ban đầu.
Truy vấn của bạn phải giống hệt nhau trong các yêu cầu tiếp theo để tận dụng dữ liệu đã lưu vào bộ nhớ đệm; các yêu cầu này sẽ không đóng góp vào hạn mức của bạn, đặc biệt là đối với quyền truy cập cơ bản. Nếu truy vấn khác và được gửi cùng với cùng một mã thông báo trang, thì lỗi sẽ được trả về.