Para recuperar las entidades de la API de Google Ads y los datos de informes, puedes utilizar uno de estos métodos:
A continuación, se muestran las distinciones de alto nivel para los dos métodos:
GoogleAdsService.SearchStream | GoogleAdsService.Search | |
---|---|---|
Adecuado para código de producción | Sí | Sí |
Servicio | GoogleAdsService |
GoogleAdsService |
Situación | Recupera informes y objetos | Recupera informes y objetos |
Respuesta | Flujo de objetos GoogleAdsRow |
Páginas de objetos GoogleAdsRow |
Campos de respuesta | Solo aquellos especificados en la consulta | Solo aquellos especificados en la consulta |
Límites diarios | Límites diarios según los niveles de acceso | Límites diarios según los niveles de acceso |
Comparación entre SearchStream y la Búsqueda
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, independientemente del tamaño del informe.
Para SearchStream
, los paquetes de datos comienzan a descargarse inmediatamente 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.
Cuando se elimina el tiempo de ida y vuelta necesario para solicitar cada página individual de una respuesta Search
, según la app, SearchStream
puede ofrecer un mejor rendimiento sobre la paginación, especialmente para informes más grandes.
Ejemplo
Toma un informe que tenga 100,000
filas, por ejemplo. En la siguiente tabla, se desglosan las diferencias contables 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:
En el caso de los informes de una sola página (de menos de 10,000 filas), no hay diferencias de rendimiento significativas entre los dos métodos.
En informes de varias páginas,
SearchStream
suele ser más rápido, ya que se evitan varias idas y vueltas y la lectura o 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 y niveles de acceso estándares 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.