Phân trang thông qua kết quả

Hỗ trợ GoogleAdsService.Search phân trang theo các kích thước trang cố định gồm 10.000 hàng. Tập hợp kết quả của truy vấn được chia tách thành nhiều phản hồi, mỗi phản hồi là 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á, thì tập hợp kết quả sẽ chứa 10.000 từ khoá đố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 vào phản hồi next_page_token. 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 xử lý việc phân trang tự động. Bạn chỉ phải lặp lại qua các hàng của câu trả lời. Khi tất cả các hàng trong trang hiện tại có được trả về, thư viện ứng dụng khách sẽ tự động tìm nạp một trang hàng mới trên cho đến khi toàn bộ tập dữ liệu được truy xuất. Nếu dùng REST để thay thế của gRPC, bạn phải đưa ra 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 trong bộ nhớ đệm, vì vậy, các yêu cầu sau đó sẽ nhanh hơn quảng cáo ban đầu.

Truy vấn của bạn phải giống hệt như vậy trong các yêu cầu tiếp theo để tận dụng của dữ liệu đã lưu vào bộ nhớ đệm; các yêu cầu đó 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 nhau 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ề.