Para recuperar entidades de la API de Google Ads y datos de informes, puedes utilizar uno de estos métodos:
Estas son las distinciones más importantes de 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 la respuesta | Solo los especificados en la consulta | Solo los 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 todo el informe, SearchStream envía una sola solicitud e 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 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.
Cuando se elimina el tiempo de red de ida y vuelta necesario para solicitar cada página individual de una respuesta de Search, según la app, SearchStream puede ofrecer un mejor rendimiento en la paginación, en especial para informes más grandes.
Ejemplo
Tomemos 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
En la mayoría de los casos de uso, recomendamos usar SearchStream en lugar de Search por los siguientes motivos:
En el caso de los 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:
SearchStreamsuele ser más rápido, ya que se evitan varios recorridos 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 estándar y los niveles de acceso de tu token de desarrollador. Una sola consulta o informe se cuenta como una operación, independientemente del resultado que se pagina o se transmite.