Paginar los resultados

Puedes paginar los resultados recuperados con GoogleAdsService.Search en lugar de descargar todo el conjunto de resultados de una vez. Para obtener una descripción general de los informes con la API de Google Ads, consulta la guía de informes.

Los resultados se devuelven en páginas de hasta 10,000 filas. Si no se establece page_size en la solicitud, el valor predeterminado es 10,000. Si page_size se establece en un valor superior a 10,000, se sigue usando 10,000.

Por ejemplo, considera la siguiente búsqueda:

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

Si tu cuenta contiene 50,000 palabras clave, el conjunto de resultados contendrá 10,000 objetos GoogleAdsRow en la primera respuesta, junto con un next_page_token.

Para recuperar las siguientes 10,000 filas, vuelve a enviar la solicitud, pero actualiza el page_token de la solicitud al next_page_token de la respuesta. Ten en cuenta que next_page_token no se propaga en la respuesta que contiene el último lote de filas.

Nuestras bibliotecas cliente controlan la paginación automáticamente. Solo tienes que iterar las filas de la respuesta. Cuando se devuelven todas las filas de la página actual, la biblioteca cliente recupera automáticamente una nueva página de filas en tu nombre hasta que se recupera todo el conjunto de datos. Si usas REST en lugar de gRPC, debes realizar una solicitud explícita para cada página nueva.

Internamente, la API de Google Ads almacena en caché todo el conjunto de datos, por lo que las solicitudes posteriores son más rápidas que la inicial.

Tu búsqueda debe seguir siendo exactamente la misma en las solicitudes posteriores para aprovechar los datos almacenados en caché. Las solicitudes no contribuirán a tu cuota, en especial para el nivel de acceso de explorador y el nivel de acceso básico. Si la búsqueda difiere y se envía junto con el mismo token de página, se devuelve un error.