El lenguaje de búsqueda de Google Ads admite la paginación especificando page_size en la solicitud. Esto dividirá el conjunto de resultados de la consulta en múltiples respuestas, cada una de las cuales contendrá hasta objetos page_size. Si no se especifica page_size, se establece automáticamente en el tamaño máximo de página de 10,000 filas.
Por ejemplo, con 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 tu cuenta contiene 50,000 palabras clave y page_size está configurada como 1,000, el conjunto de resultados contendrá 1,000 objetos GoogleAdsRow en la primera respuesta, junto con un next_page_token. Para recuperar las siguientes mil filas, vuelve a enviar la solicitud con el mismo tamaño de página, pero actualiza el page_token de la solicitud al next_page_token de la respuesta. El valor de page_size en las solicitudes posteriores puede ser diferente cada vez.
Nuestras bibliotecas cliente manejan la paginación automáticamente. Solo debes iterar a través de las filas de la respuesta. Cuando se muestren todas las filas de la página actual, la biblioteca cliente recuperará una página nueva de filas automáticamente por ti hasta que se haya recuperado el conjunto de datos completo. Si usas REST en lugar de gRPC, debes realizar una solicitud explícita para cada página nueva.
La API de Google Ads almacena en caché todo el conjunto de datos internamente, por lo que las solicitudes posteriores son más rápidas que la primera. Según tu caso de uso, puedes configurar page_size en cualquier valor entre 1 y 10,000. En general, para obtener un rendimiento general más rápido, deberías usar un page_size más grande, ya que hay menos recorridos de ida y vuelta en tus respuestas.
Tu consulta debe ser la misma en las solicitudes posteriores para aprovechar los datos almacenados en caché. Las solicitudes no contribuirán a tu cuota, en particular, para el acceso básico. Si la consulta difiere y se envía junto con el token de la página, se generará un error.