Informa la transmisión con GoogleAdsService

Para recuperar entidades de la API de Google Ads y datos de informes, usa uno de los siguientes métodos:

Estas son las distinciones de alto nivel de los dos métodos:

GoogleAdsService.SearchStream GoogleAdsService.Search
Adecuada para el código de producción
Servicio GoogleAdsService GoogleAdsService
Situación Cómo recuperar objetos e informes Cómo recuperar objetos e informes
Respuesta Transmisión de objetos GoogleAdsRow Páginas de objetos GoogleAdsRow
Campos de la respuesta Solo las que se especifican en la consulta Solo las que se especifican en la consulta
Límites diarios Límites diarios según los niveles de acceso Límites diarios según los niveles de acceso

Si bien Search puede enviar varias solicitudes paginadas para descargar el informe completo, SearchStream envía una sola solicitud y, luego, inicia una conexión persistente con la API de Google Ads, independientemente del 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 finalice 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 rendimiento mejorado en comparación con la paginación, especialmente para informes más grandes.

Ejemplo

En este ejemplo, se analiza un informe que consta de 100,000 filas. En la siguiente tabla, se desglosan las diferencias de contabilización entre los dos métodos.

SearchStream 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

Para la mayoría de los casos de uso, 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 significativas de rendimiento entre los dos métodos.

  • En el caso de los informes de varias páginas, SearchStream suele ser más rápido, ya que se evitan varios recorridos y la lectura o escritura desde la caché del disco es menos importante.

Límites de frecuencia

Los límites diarios de ambos métodos se adhieren a los límites estándar y a los niveles de acceso de tu token de desarrollador. Una sola consulta o informe se cuenta como una operación, independientemente de si el resultado se pagina o se transmite.