É possível paginar os resultados recuperados com GoogleAdsService.Search
em vez de fazer o download de todo o conjunto de resultados de uma só vez. Para uma visão geral dos
relatórios com a API Google Ads, consulte o
guia de relatórios.
Os resultados são retornados em páginas de até 10.000 linhas. Se page_size na solicitação não estiver definido, o padrão será 10.000. Se page_size estiver definido como um valor maior que 10.000, ele ainda usará 10.000.
Por exemplo, considere 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 vai conter 10.000
GoogleAdsRow objetos na primeira resposta, além de um
next_page_token.
Para recuperar as próximas 10.000 linhas, envie a solicitação novamente, mas atualize o
page_token da solicitação para o next_page_token da resposta. Observe que
next_page_token não é preenchido na resposta que contém o
último lote de linhas.
Nossas bibliotecas de cliente processam a paginação automaticamente. Basta iterar pelas linhas da resposta. Quando todas as linhas da página atual forem retornadas, a biblioteca de cliente vai buscar uma nova página de linhas automaticamente em seu nome até que todo o conjunto de dados seja recuperado. Se você estiver usando REST em vez de gRPC, será necessário fazer uma solicitação explícita para cada nova página.
A API Google Ads armazena em cache internamente todo o conjunto de dados, de modo que as solicitações subsequentes sejam mais rápidas do que a inicial.
A consulta precisa permanecer exatamente a mesma nas solicitações subsequentes para aproveitar os dados armazenados em cache. As solicitações não contribuem para sua cota, principalmente para os níveis de acesso de explorador e básico. Se a consulta for diferente e enviada com o mesmo token de página, um erro será retornado.