결과 페이징

GoogleAdsService.Search 지원 10,000행의 고정된 페이지 크기로 페이지를 생성할 수 있습니다 쿼리의 결과 집합이 분할됨 각각 10,000개의 객체로 변환합니다.

다음 쿼리를 예로 들어 보겠습니다.

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

계정에 포함된 키워드가 50,000개이면 결과 집합에는 10,000개의 키워드가 포함됩니다. GoogleAdsRow 객체 next_page_token도 함께 표시됩니다.

다음 10,000개 행을 검색하려면 요청을 다시 전송하되 요청의 page_token를 응답의 next_page_token next_page_token 행의 마지막 배치가 포함된 응답에 채워지지 않습니다.

클라이언트 라이브러리는 페이징을 자동으로 처리합니다. 반복하기만 하면 됨 확인할 수 있습니다 현재 페이지의 모든 행에 반환되면 클라이언트 라이브러리는 새 행 페이지를 자동으로 전체 데이터 세트가 검색될 때까지 자동으로 수행됩니다 REST를 대신 사용하는 경우 새 페이지마다 명시적으로 요청해야 합니다.

Google Ads API는 전체 데이터 세트를 내부적으로 캐시하므로 이후의 요청은 훨씬 빠릅니다

이 기능을 활용하려면 후속 요청에서 쿼리가 정확히 동일하게 유지되어야 합니다. 처리되기 때문에 요청은 할당량에 반영되지 않지만 특히 기본 액세스에 적합합니다. 만약 쿼리가 다르며 동일한 페이지 토큰과 함께 전송되면 오류가 반환됩니다.

이전
스트리밍
다음
UI 보고서