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

Jueves, 26 de febrero de 2026

Esta importante actualización transforma al asistente de una potente herramienta de generación de código en un socio proactivo de solución de problemas y automatización para los desarrolladores de Google Ads. Desde el lanzamiento de la versión 1.6.0, escuchamos tus comentarios y nos enfocamos en las partes más desafiantes del desarrollo de APIs: el diagnóstico, la coherencia y la configuración.

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

1. Instalación y mantenimiento más sencillos

Configurar un entorno de desarrollo en varios lenguajes no debería ser una tarea difícil.

  • Configuración con un solo comando: Usa la nueva marca --install-deps con install.sh o install.ps1 para controlar las dependencias de pip, composer y bundler de una sola vez.
  • Estructura de directorio unificada: Todo el código generado, las exportaciones de CSV y los informes de diagnóstico ahora se organizan en un solo directorio saved/ con subdirectorios para cada tipo de resultado.
  • Actualización con un comando: Cuando se lanza una nueva versión de la API y las bibliotecas cliente, debes ejecutar update.sh para trabajar con la versión más reciente. También puedes usar update.sh para agregar bibliotecas cliente adicionales a tu contexto.

2. Solución de problemas de conversión de agentes

El seguimiento de conversiones sin conexión es una de las funciones más potentes, pero complejas, de la API de Google Ads. Depurar por qué no se atribuyó una conversión puede ser un proceso manual que requiere mucho tiempo.

En la versión 2.0, presentamos un paquete exclusivo de solución de problemas y diagnóstico de conversiones.

  • Nueva secuencia de comandos: api_examples/collect_conversions_troubleshooting_data.py
  • Comando nuevo: /conversions_support_data

La secuencia de comandos ejecuta informes estándares para solucionar problemas de conversiones y proporciona contexto para que el asistente solucione tus problemas.

El comando es más útil después de que el asistente haya analizado tu problema de conversión y haya intentado resolverlo. Si no puede hacerlo y necesitas comunicarte con el equipo de asistencia, este comando analizará la configuración de tu cliente, las acciones de conversión y los resúmenes de carga para generar un informe de diagnóstico estructurado basado en el análisis ya realizado. Incluso identifica automáticamente los estados "en mal estado" y los altos porcentajes de fallas, lo que te ahorra horas de búsqueda en los registros. Guarda los resultados en un archivo de texto que puedes incluir en una solicitud de asistencia si necesitas presentar una.

3. Compilada para la API más reciente (v23)

La versión 2.0 es totalmente compatible con la API de Google Ads v23. Se actualizaron todos nuestros ejemplos interactivos, y el contexto interno del asistente ahora está optimizado para los recursos y campos más recientes, lo que garantiza que el código que generes esté listo para producción.

4. Automatización sin interrupciones con hooks de sesión

Agregamos hooks de SessionStart y SessionEnd para que tu flujo de trabajo sea realmente fluido.

  • Configuración automática: El asistente ahora puede ubicar automáticamente tu archivo de configuración en el directorio $HOME al comienzo de una sesión. Se copia en el subdirectorio config del directorio de tu proyecto. Python es el lenguaje preferido de Gemini para consultar la API. Por lo tanto, si usas otro lenguaje, lee tu archivo de configuración y crea un archivo google-ads.yaml temporal en config para sus consultas, pero sigue respondiendo en el código de tu lenguaje preferido.
  • Limpieza automática: Los parámetros de configuración temporales se borran de forma segura cuando sales, lo que mantiene limpio tu espacio de trabajo y seguras tus credenciales.

5. Validación de GAQL más inteligente

Crear consultas complejas de GAQL es más fácil que nunca. Actualizamos GEMINI.md y conversions/GEMINI.md con reglas de validación rigurosas para los casos extremos más recientes de la API, lo que incluye un mejor manejo de los segmentos de fechas y los requisitos de rango finito. Ahora, el asistente detecta errores de lógica antes de que ejecutes la consulta.

6. Habilidades

Piensa en una habilidad como un mini complemento o un "plano de comportamiento". Si bien el contexto general (como tu archivo GEMINI.md) proporciona información de contexto, una habilidad solo se "carga" en el cerebro de la IA cuando necesita realizar específicamente una tarea compleja y procedimental, como obtener la versión actual de esta extensión. No ejecutas la habilidad directamente. Gemini decide cuándo lo necesita.

Aunque todavía es una función experimental, incluimos una con esta versión para complementar nuestro uso de hooks para la inicialización y limpieza de sesiones.

¿Por qué deberías actualizar?

El salto de la versión 1.6.0 a la 2.0.0 no solo se trata de nuevas funciones, sino también de la confiabilidad. Al integrar un conocimiento profundo de las APIs con herramientas de diagnóstico automatizadas, la versión 2.0 reduce el ciclo de "prueba y error" que suele ralentizar la integración de APIs.

Ya sea que depures cargas de conversiones o crees canalizaciones de informes complejas, la versión 2.0 te brinda las herramientas para trabajar más rápido y con más confianza.

Primeros pasos

Primera instalación

Actualiza desde una versión anterior

  • Copia cualquier código personalizado de saved_code/ y saved_csv/ en una ubicación segura.
  • Borra tu clon local del Asistente para desarrolladores de la API de Google Ads. Para ello, borra el directorio de tu proyecto y todos los subdirectorios y archivos.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • En el directorio del proyecto, ejecuta install.sh o install.ps1 para instalar la extensión y las bibliotecas cliente.

Bob Hancock, equipo de la API de Google Ads

Etiquetas: google-ads-api, release