Paginar los resultados

GoogleAdsService.Search admite de paginación en tamaños de página fijos de 10,000 filas. El conjunto de resultados de la consulta se divide en múltiples respuestas, cada una de las cuales 10,000 objetos.

A modo de ejemplo, para la siguiente 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

Si su 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 el page_token de la solicitud a la next_page_token Ten en cuenta que next_page_token No se propaga en la respuesta que contiene el último lote de filas.

Nuestras bibliotecas cliente manejan la paginación automáticamente. Solo tienes que iterar a través de las filas de la respuesta. Cuando todas las filas de la página actual tengan se muestra, la biblioteca cliente recupera automáticamente una nueva página de filas en hasta que se recupere el conjunto de datos completo. Si usas REST en su lugar de gRPC, debes hacer explícitamente una solicitud para cada página nueva.

La API de Google Ads almacena internamente en caché todo el conjunto de datos, por lo que las solicitudes posteriores se más rápido que el inicial.

Tu consulta debe permanecer igual en las solicitudes posteriores para que puedas aprovechar de los datos almacenados en caché; las solicitudes no contribuirán a tu cuota, especialmente para el acceso básico. Si el botón una consulta difiere y se envía junto con el mismo token de la página, se muestra un error.