GoogleAdsService.Search oferece suporte
paginação em tamanhos de página fixos de 10.000 linhas. O conjunto de resultados da consulta é dividido
em várias respostas, cada uma com 10.000 objetos.
Como exemplo, para a seguinte consulta:
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
Se a conta tiver 50.000 palavras-chave, o conjunto de resultados terá 10.000
objetos GoogleAdsRow na primeira resposta,
junto com um next_page_token.
Para recuperar as próximas 10.000 linhas, envie a solicitação novamente, mas atualize o
o page_token da solicitação ao arquivo
next_page_token.
Observe que next_page_token
não é preenchido na resposta que contém o último lote de linhas.
Nossas bibliotecas cliente lidam com a paginação automaticamente. Você só precisa iterar pelas linhas de resposta. Quando todas as linhas da página atual têm for retornado, a biblioteca de cliente busca uma nova página de linhas automaticamente no em seu nome até que todo o conjunto de dados seja recuperado. Se estiver usando REST em vez disso do gRPC, é preciso fazer uma solicitação explícita para cada nova página.
A API Google Ads armazena internamente todo o conjunto de dados em cache para que as solicitações subsequentes sejam mais rápido que o primeiro.
Sua consulta precisa permanecer exatamente a mesma nas solicitações subsequentes para aproveitar dos dados armazenados em cache. as solicitações não contribuirão para sua cota, especialmente para o acesso básico. Se o consulta for diferente e for enviada junto com o mesmo token de página, um erro será retornado.