Presentamos la versión 3.0.0 del Asistente para desarrolladores de la API de Google Ads

Miércoles, 10 de junio de 2026

Nos complace anunciar el lanzamiento de la versión 3.0.0 del Asistente para desarrolladores de la API de Google Ads. Esta versión principal marca un hito significativo en la evolución del Asistente, ya que se enfoca en la modernización de la arquitectura, una mayor confiabilidad y un diseño más modular.

Con esta versión, migraremos el asistente al framework de agentes de Google Antigravity y realizaremos la transición a una arquitectura basada en habilidades. Estos cambios hacen que el asistente sea más sólido, más fácil de mantener y reducen el uso de tokens.

¿Qué novedades hay en la versión 3.0.0?

1. Con la tecnología del framework de Antigravity

El asistente para desarrolladores de la API de Google Ads migró de gemini-cli al framework de agentes de Antigravity (v3.0.0). Esta actualización del framework subyacente proporciona un entorno de ejecución más estructurado y confiable. Además, se actualizó la estructura de directorios y archivos del proyecto para que sea totalmente compatible con Antigravity.

La asistencia para gemini-cli finalizará el 18 de junio de 2026, como se detalla en este anuncio del blog de Google.

2. Una arquitectura modular basada en habilidades

Transferimos las funciones principales de Asistente a las habilidades. En lugar de depender de instrucciones amplias y no estructuradas en un archivo de contexto, el Asistente ahora carga directorios de herramientas especializados y respaldados por pruebas (habilidades) de forma dinámica cuando es necesario. Esto reduce drásticamente las "alucinaciones" y garantiza que las tareas se ejecuten con procedimientos precisos y verificados.

Entre las actualizaciones clave de esta transición modular, se incluyen las siguientes:

  • Validación de GAQL (validate_gaql): Se trasladó a una habilidad dedicada. Ahora incluye verificaciones de consultas estáticas mejoradas para segmentos de fechas, filtros de un solo día de click_view y límites de change_status.
  • Soluciona problemas relacionados con las conversiones (troubleshoot_conversions): Reemplaza el antiguo conversions_support_package. Consolida todas las secuencias de comandos de solución de problemas de conversiones y de resumen de cargas, así como las pruebas, en un único directorio de habilidades coherente.
  • Comandos estructurados (explain y step_by_step): Se convirtieron en habilidades para aplicar diseños coherentes y estructurados para las explicaciones.
  • Asignación de cuentas nuevas (get_cids_under_mcc): Es una nueva habilidad para recuperar todas las cuentas infantiles de una cuenta de administrador (MCC).
  • Inspección de objetos nuevos (inspect_object): Es una nueva habilidad para buscar de forma dinámica mensajes y enumeraciones de Protobuf sobre la marcha, lo que ayuda a garantizar que el Asistente siempre use las estructuras correctas.
  • Nuevo filtro de fichas de campañas de máximo rendimiento (pmax_listing_filter): Es una nueva habilidad para estandarizar las modificaciones del árbol de exclusión de páginas web de los grupos de fichas en las campañas de máximo rendimiento.

3. Mayor coherencia y rigurosidad

Introdujimos reglas y requisitos más estrictos para garantizar la generación de código y la validación de consultas de alta calidad:

  • Control de versiones explícito de la API: Las habilidades críticas, como get_cids_under_mcc, validate_gaql y troubleshoot_conversions, ahora requieren un argumento api_version explícito, lo que elimina la ambigüedad.
  • Reglas estrictas de GAQL:
    • Se agregó una regla a AGENTS.md para evitar el uso de funciones de agregación de SQL (como SUM, COUNT y AVG) en las consultas de GAQL, ya que no son compatibles.
    • Se agregó una regla para consultar primero las notas de la versión del sitio para desarrolladores de la API de Google Ads de la versión actual de la API para garantizar que el asistente use documentación actualizada.
    • Configuración optimizada: Se optimizó AGENTS.md, lo que genera una ventana de contexto inicial más pequeña. Se quitó la documentación sobre la conversión de duplicados para dar prioridad a las habilidades de programación.

4. Mejoras en la experiencia de los desarrolladores (DX)

Realizamos varias mejoras de calidad de vida para que tu ciclo de desarrollo sea más rápido y fluido:

  • Entorno virtual persistente (.venv): El entorno virtual ya no se borra al final de una sesión. Durante el inicio, el asistente verifica la versión de Python de tu sistema y solo vuelve a compilar el .venv si hay una versión más reciente de Python disponible.
  • Almacenamiento en caché inteligente de la versión de la API: El asistente ahora almacena en caché la versión actual de la API de Google Ads con un TTL de 19 horas, lo que reduce el tiempo de inicio, ya que evita las verificaciones de red redundantes.
  • Mejor depuración con registros persistentes: Los mensajes de registro ahora incluyen marcas de fecha y hora. El archivo de registro se escribe en el directorio .agents/ y ya no se restablece en cada ejecución, lo que conserva el historial para solucionar problemas.

¿Por qué deberías actualizar?

La actualización a la versión 3.0.0 se centra principalmente en la confiabilidad y la estructura. Al migrar al framework de Antigravity y modularizar las funciones en Skills, logramos que el Asistente sea más predecible y eficiente en el uso de recursos.

Si quieres un inicio más rápido, una validación de GAQL más confiable y una experiencia de solución de problemas más sólida, te recomendamos que actualices a la versión 3.0.0.

Comenzar

Primera instalación

  1. Instala la CLI de Antigravity: Sigue las instrucciones que se indican en https://antigravity.google/.
  2. Clona el asistente: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. Ejecuta la secuencia de comandos de instalación:
    • Linux/macOS: Ejecuta ./install.sh (la compatibilidad con Python es la opción predeterminada; usa marcas como --php o --ruby para otros lenguajes).
    • Windows: Abre PowerShell y ejecuta .\install.ps1.

Actualiza desde la versión 2.x

  1. Copia cualquier código o dato personalizado de saved/ a una ubicación segura fuera del directorio del proyecto.
  2. Borra el clon local del Asistente.
  3. Clona el repositorio:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. Ejecuta la secuencia de comandos de instalación (install.sh o install.ps1) para inicializar el nuevo entorno de Antigravity.

Bob Hancock, equipo de la API de Google Ads

Etiquetas: google-ads-api, release