Los scripts 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 los scripts de Google Ads, puedes automatizar los flujos de trabajo de administración de cuentas de rutina, generar informes personalizados y, además, integrar Google Ads con fuentes de datos externas, en una o miles de cuentas, sin aprovisionar servidores ni administrar credenciales de desarrollador.
La mayoría de las funciones de Google Ads están disponibles en los scripts de Google Ads a través de las llamadas mutate y search. Puedes usar secuencias de comandos para hacer lo siguiente:
- Administrar campañas, grupos de anuncios, palabras clave y anuncios
- Ajusta las ofertas, los presupuestos y el estado según el rendimiento en tiempo real o los datos externos.
- Ejecuta consultas con el lenguaje de consulta de Google Ads (GAQL) para generar informes y paneles personalizados.
- Programa ejecuciones automatizadas para que se ejecuten cada hora, todos los días, todas las semanas, todos los meses o según sea necesario.
- Coordina las operaciones de varias cuentas en las cuentas secundarias con las secuencias de comandos de administrador.
- Conéctate 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.
Los guiones 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 los scripts de Google Ads:
| Especificación | Secuencia de comandos para una sola cuenta | Secuencia de comandos de la cuenta de administrador |
|---|---|---|
| Tiempo de espera de ejecución | Máximo 30 minutos |
Hasta 60 minutos con executeInParallel y una devolución de llamada
(30 minutos estándar)
|
| Motor de entorno de ejecución | Entorno de ejecución de JavaScript V8 (ECMAScript 6+) | Entorno de ejecución de JavaScript V8 (ECMAScript 6+) |
| Límite de iteradores de entidades | 50,000 entidades predeterminadas por iterador (los informes y las consultas de búsqueda 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.
¿Los scripts de Google Ads son 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 según tus necesidades:
| Situación | Recomendación | Características principales |
|---|---|---|
| Soy un desarrollador que desea crear su propio producto de software o integrarlo 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 capacidad de procesamiento, hosting dedicado y administración de OAuth. |
| Soy un desarrollador que se siente cómodo escribiendo código, pero prefiero no administrar mi propia infraestructura de software. | Utiliza 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 a programar para automatizar Google Ads. | Utiliza secuencias de comandos de Google Ads. | Sintaxis de JavaScript simple, plantillas de secuencias de comandos compiladas previamente, autocompletado de IDE y resaltado de sintaxis. |
| Quiero administrar campañas de video de manera programática. | Utiliza 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. | Utiliza secuencias de comandos de Google Ads. | Autorización en segundo plano de OAuth2 con programación automatizada por hora, día, semana o mes. |
| Quiero acceder de manera programática a mis cuentas de Google Ads anidadas. | 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. | 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, Mail), 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 realizar un análisis más detallado. | Usa el Servicio de transferencia de datos de BigQuery para Google Ads. | Canalización automatizada y programada para los datos de Google Ads en BigQuery sin código. |
| Quiero administrar Google Ads de forma masiva y no me importa escribir código. | Usa las cargas masivas con las secuencias de comandos de Google Ads. | Carga programática de archivos CSV o de hojas de cálculo que admite hasta 1,000,000 de filas |
| Quiero administrar Google Ads de forma masiva, pero no quiero escribir ningún código. | Usa reglas automáticas, cargas masivas o Google Ads Editor. | Herramientas de IU o de escritorio sin código para actualizaciones masivas y reglas programadas. |
Requisitos previos
Solo se necesita un conocimiento básico de JavaScript, ya que el IDE ayuda con el resaltado de sintaxis, el autocompletado y la vista previa. Solo necesitas 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 los scripts de Google Ads.
¿Qué son los scripts 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 desarrolladores escriban código de 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 infraestructura.
¿En qué se diferencian los scripts 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 y credenciales de OAuth dedicados.
¿Necesito un servidor para ejecutar secuencias de comandos de Google Ads?
No. Los scripts de Google Ads se ejecutan por completo en la infraestructura de 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 los scripts de Google Ads?
Las secuencias de comandos estándar en cuentas individuales pueden ejecutarse durante un máximo de 30 minutos por
ejecución. Las secuencias de comandos de la cuenta de administrador que usan executeInParallel se pueden ejecutar
durante un máximo de 60 minutos en hasta 50 cuentas infantiles (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 sigue aplicando 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.
¿Los scripts de Google Ads pueden conectarse a APIs externas?
Sí. Los scripts 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 de Google avanzadas para la integración con servicios como BigQuery y YouTube. Para obtener más detalles, consulta
APIs de terceros
y APIs de Google avanzadas.
Comentarios
Si tienes algún comentario sobre los scripts de Google Ads, nos encantaría conocerlo. Comunícate con nosotros en Discord.
Si necesitas ayuda, comunícate con el equipo de asistencia técnica de secuencias de comandos.