Las secuencias de comandos de Google Ads proporcionan una plataforma de automatización sin servidores que te permite administrar y consultar tus datos de anuncios de Google Ads de forma programática con JavaScript moderno (ES6+) en un IDE basado en el navegador. Con las secuencias de comandos de Google Ads, puedes automatizar los flujos de trabajo de administración de cuentas de rutina, generar informes personalizados y conectar Google Ads con fuentes de datos externas (en una cuenta o en miles de cuentas) sin aprovisionar servidores ni administrar credenciales de desarrollador.
La mayoría de las funciones de Google Ads están disponibles en las secuencias de comandos de Google Ads a través de mutación y búsqueda llamadas. Puedes usar secuencias de comandos para hacer lo siguiente:
- Administrar campañas, grupos de anuncios, palabras clave, y anuncios.
- Ajustar las ofertas, los presupuestos y el estado en función del rendimiento en tiempo real o de datos externos
- Ejecutar consultas con el lenguaje de consulta de Google Ads (GAQL) para generar informes personalizados y paneles.
- Programar ejecuciones automáticas para que se ejecuten cada hora, todos los días, todas las semanas, todos los meses o a pedido
- Coordinar operaciones de varias cuentas en las cuentas secundarias con secuencias de comandos de administrador.
- Conectarse a los servicios de Google Workspace (como Hojas de cálculo y Drive), los servicios de Google Cloud (como BigQuery) y las APIs de terceros.
Las secuencias de comandos también incluyen selectores de entidades y informes integrados.
Especificaciones técnicas clave
Las siguientes especificaciones técnicas definen el entorno de ejecución y los límites operativos de las secuencias de comandos de Google Ads:
| Especificación | Secuencia de comandos de una sola cuenta | Secuencia de comandos de la cuenta de administrador |
|---|---|---|
| Tiempo de espera de ejecución | Máximo de 30 minutos |
Hasta 60 minutos con executeInParallel y una devolución de llamada
(30 minutos estándar)
|
| Motor de tiempo de ejecución | Tiempo de ejecución de JavaScript V8 (ECMAScript 6+) | Tiempo de ejecución de JavaScript V8 (ECMAScript 6+) |
| Límite del iterador de entidades | 50,000 entidades predeterminadas por iterador (los informes y las búsquedas están exentos) | 50,000 entidades por cuenta secundaria (los informes y las búsquedas están exentos) |
| Cuentas paralelas | N/A (1 cuenta) | Hasta 50 cuentas en paralelo |
| Límite de carga masiva | Tamaño de archivo de 50 MB, 1,000,000 de filas | Tamaño de archivo de 50 MB, 1,000,000 de filas |
| Secuencias de comandos autorizadas | Hasta 250 secuencias de comandos autorizadas por usuario | Hasta 250 secuencias de comandos autorizadas por usuario |
| Hosting e infraestructura | Completamente administrado por Google (sin servidores) | Completamente administrado por Google (sin servidores) |
Para obtener más información, consulta Límites.
¿Son las secuencias de comandos de Google Ads el producto adecuado para mí?
Google proporciona varios productos para ayudar a automatizar las cuentas de Google Ads. En la siguiente tabla, se describen situaciones y recomendaciones comunes para ayudarte a elegir el producto adecuado para tus necesidades:
| Situación | Recomendación | Características principales |
|---|---|---|
| Soy desarrollador y quiero crear mi propio producto de software o integrar con la API de Google Ads. Me siento cómodo escribiendo código y administrando la infraestructura de software incluidos los servidores y las bases de datos. | Usa la API de Google Ads. | Control total de la API, mayor rendimiento, hosting dedicado y administración de OAuth |
| Soy desarrollador y me siento cómodo escribiendo código, pero prefiero no administrar mi propia infraestructura de software. | Usa las secuencias de comandos de Google Ads. | Ejecución sin servidores dentro de Google Ads, programación automatizada, IDE basado en el navegador |
| No soy desarrollador, pero estoy dispuesto a invertir algo de tiempo en aprender programación para automatizar Google Ads. | Usa las secuencias de comandos de Google Ads. | Sintaxis simple de JavaScript, plantillas de secuencias de comandos precompiladas, autocompletado de IDE y resaltado de sintaxis |
| Quiero administrar campañas de video de forma programática. | Usa las secuencias de comandos de Google Ads. |
Administración directa de campañas de video con
AdsApp.videoCampaigns().
|
| Quiero programar tareas para que se ejecuten sin necesidad de una sesión de usuario activa. | Usa las secuencias de comandos de Google Ads. | Autorización en segundo plano de OAuth2 con programación automatizada por hora, diaria, semanal, o mensual |
| Quiero acceder a mis cuentas de Google Ads anidadas de forma programática. | Usa secuencias de comandos de administrador para acceder a las cuentas secundarias de publicación desde una sola secuencia de comandos. |
Iteración secuencial en las cuentas secundarias o ejecución paralela en
hasta 50 cuentas secundarias con executeInParallel.
|
| Quiero integrar APIs de Google o de terceros en mi administración de Google Ads management. | Usa las APIs de Google o las APIs de terceros con las secuencias de comandos de Google Ads. |
Servicios integrados de Google Workspace (Hojas de cálculo, Drive, Correo electrónico), APIs avanzadas de Google (BigQuery, Analytics, YouTube) y UrlFetchApp para
APIs de REST externas
|
| Soy analista de datos (o tengo un rol similar) y quiero descargar informes de Google Ads para analizarlos más a fondo. | Usa el Servicio de transferencia de datos de BigQuery para Google Ads. | Canalización automatizada programada para datos de anuncios de Google Ads en BigQuery sin código |
| Quiero administrar Google Ads de forma masiva y no me importa escribir código. | Usa cargas masivas con las secuencias de comandos de Google Ads. | Carga programática de CSV o de hojas de cálculo que admite hasta 1,000,000 filas |
| Quiero administrar Google Ads de forma masiva, pero no quiero escribir código. | Usa reglas automáticas, cargas masivas, o Google Ads Editor. | Herramientas de escritorio o de IU sin código para actualizaciones masivas y reglas programadas |
Requisitos previos
Solo se necesita un conocimiento básico de JavaScript. El IDE ayuda con el resaltado de sintaxis, el autocompletado y la vista previa. Todo lo que necesitas es una cuenta de Google Ads para comenzar a escribir tu primera secuencia de comandos.
Preguntas frecuentes
Encuentra respuestas a preguntas frecuentes sobre la arquitectura, los límites de ejecución y las integraciones de las secuencias de comandos de Google Ads.
¿Qué son las secuencias de comandos de Google Ads?
Las secuencias de comandos de Google Ads proporcionan un entorno de automatización sin servidores dentro de Google Ads. Permiten que los anunciantes y los desarrolladores escriban código JavaScript para consultar métricas de rendimiento, crear y modificar campañas, actualizar ofertas y presupuestos, y conectarse con APIs externas sin configurar servidores, administrar tokens de OAuth ni pagar por la infraestructura.
¿En qué se diferencian las secuencias de comandos de Google Ads de la API de Google Ads?
Las secuencias de comandos de Google Ads se ejecutan directamente en tu cuenta de Google Ads con JavaScript, no requieren infraestructura de servidor y controlan la autorización automáticamente en el navegador. La API de Google Ads es una API de REST y gRPC diseñada para aplicaciones empresariales a gran escala, herramientas de terceros y canalizaciones de datos de gran volumen que se ejecutan en tus propios servidores y requieren tokens de desarrollador dedicados y credenciales de OAuth.
¿Necesito un servidor para ejecutar secuencias de comandos de Google Ads?
No. Las secuencias de comandos de Google Ads se ejecutan por completo en la infraestructura de la nube de Google sin costo adicional. Puedes crear secuencias de comandos, probarlas con el modo de vista previa y programarlas directamente en la interfaz web de Google Ads.
¿Cuáles son los límites de ejecución de las secuencias de comandos de Google Ads?
Las secuencias de comandos estándar en cuentas individuales pueden ejecutarse hasta por 30 minutos por ejecución. Las secuencias de comandos de la cuenta de administrador que usan executeInParallel pueden ejecutarse hasta por 60 minutos en hasta 50 cuentas secundarias (cuando se especifica una función de devolución de llamada). Si se agota el tiempo de espera de una secuencia de comandos, Google Ads aplica los cambios realizados antes de la cancelación. Consulta Límites
para obtener detalles completos sobre los tiempos de espera, las cuotas y los límites de carga masiva.
¿Pueden las secuencias de comandos de Google Ads conectarse a APIs externas?
Sí. Las secuencias de comandos de Google Ads incluyen servicios integrados, como SpreadsheetApp para leer y escribir Hojas de cálculo de Google, UrlFetchApp para enviar solicitudes HTTP a APIs de REST externas y APIs avanzadas de Google para realizar integraciones con servicios como BigQuery y YouTube. Para obtener más detalles, consulta
APIs de terceros
y APIs avanzadas de Google.
Comentarios
Si tienes comentarios sobre las secuencias de comandos de Google Ads, nos encantaría escucharlos. Comunícate con nosotros en Discord.
Si necesitas asistencia, comunícate con el equipo de asistencia técnica para secuencias de comandos.