Transmisión de informes

Existen tres métodos para recuperar entidades y crear informes de datos con la API de Google Ads.

Esta guía se enfoca principalmente en datos de transmisión de GoogleAdsService. Aquí hay distinciones de alto nivel para los tres métodos de recuperación de datos:

GoogleAdsService.SearchStream GoogleAdsService.Search. Solicitudes GET
Adecuado para código de producción Sí Sí No (solo para depuración)
Servicios GoogleAdsService GoogleAdsService Servicios específicos de recursos (por ejemplo, CampaignService)
Situación Cómo recuperar informes y objetos Cómo recuperar informes y objetos Recuperando objetos
Respuesta Transmisión de objetos GoogleAdsRow Páginas de objetos GoogleAdsRow Un objeto (por ejemplo, Campaign)
Campos de la respuesta Solo aquellos especificados en la consulta Solo aquellos especificados en la consulta Se propagaron todos los campos
Límites diarios Límites diarios en función de los niveles de acceso Límites diarios en función de los niveles de acceso 1,000 solicitudes por día

Si bien Search puede enviar varias solicitudes paginadas para descargar el informe completo, SearchStream envía una sola solicitud e inicia una conexión persistente con la API de Google Ads, sin importar el tamaño del informe.

En el caso de SearchStream, los paquetes de datos comienzan a descargarse de inmediato con todo el resultado almacenado en caché en un búfer de datos. Tu código puede comenzar a leer los datos almacenados en búfer sin tener que esperar a que termine toda la transmisión.

Al eliminar el tiempo de red de ida y vuelta necesario para solicitar cada página individual de una respuesta Search, según tu app, SearchStream puede ofrecer un mejor rendimiento sobre la paginación, en especial para informes más grandes.

Ejemplo

Toma un informe que consta de 100,000 filas, por ejemplo. En la siguiente tabla, se desglosan las diferencias de conteo entre los dos métodos.

Novedades de búsqueda Buscar
Tamaño de la página No aplicable 10,000 filas por página
Cantidad de solicitudes a la API 1 solicitud 10 solicitudes
Cantidad de respuestas de la API 1 transmisión continua 10 respuestas

Factores de rendimiento

En general, recomendamos SearchStream en lugar de Search por los siguientes motivos.

  • Para informes de una sola página (menos de 10,000 filas): No hay diferencias de rendimiento significativas entre los dos métodos.

  • Para informes de varias páginas, SearchStream suele ser más rápido, ya que se evitan varias idas y vueltas y la lectura/escritura desde la caché de disco es menos importante.

Límites de frecuencia

Los límites diarios de ambos métodos cumplen con los límites estándares y los niveles de acceso de tu token de desarrollador. Una sola consulta o informe se cuenta como una operación sin importar el resultado que se pagina o se transmite.