Para recuperar entidades de la API de Google Ads y datos de informes, usa uno de estos métodos:
Estas son las distinciones generales de los dos métodos:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| Adecuado para código de producción | Sí | Sí |
| Servicio | GoogleAdsService |
GoogleAdsService |
| Situación | Recuperación de objetos y de informes | Recuperación de objetos y de informes |
| Respuesta | Transmisión de objetos GoogleAdsRow |
Páginas de GoogleAdsRow objetos |
| Campos de respuesta | Solo los especificados en la consulta | Solo los especificados en la consulta |
| Límites diarios | Límites diarios basados en niveles de acceso | Límites diarios basados en niveles de acceso |
SearchStream en comparación con Search
Si bien Search puede enviar varias
solicitudes paginadas para descargar el informe completo, SearchStream envía una sola solicitud y
establece 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 el resultado completo 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 ida y vuelta de la red necesario para solicitar cada página individual
de una respuesta Search, según tu app, SearchStream puede ofrecer
un mejor rendimiento que la paginación, en especial 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 contables entre los dos métodos.
| SearchStream | Search | |
|---|---|---|
| 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.
Para informes de varias páginas: Por lo general,
SearchStreames más rápido, ya que se evitan varios viajes de ida y vuelta, y la lectura o escritura desde la memoria caché del disco es menos importante.
Límites de frecuencia
Los límites diarios para ambos métodos cumplen con los límites estándar y los niveles de acceso de tu token de desarrollador. Una sola consulta o informe se cuenta como una operación, independientemente de que el resultado se pagine o se transmita.