%20Migration%20Guide.avif)
La API v19 de Google Ads deja de funcionar 11 de febrero de 2026. Si utilizas scripts personalizados, conectores de terceros o herramientas de generación de informes automatizados que no se han actualizado, tus integraciones fallarán por completo a partir de esa fecha.
Google anunció la puesta de sol de la v19 el 15 de diciembre de 2025. Eso les dio a los desarrolladores acerca de dos meses para migrar. La versión 19 se lanzó el 26 de febrero de 2025, lo que significa que obtuvo el estándar Vida útil de 12 meses antes de la desaprobación.
Por qué las versiones de la API de Google Ads quedan en desuso
Google mantiene un máximo de cuatro versiones de API simultáneas. ¿Cuándo? v23 se envió el 28 de enero de 2026, el reloj de la v19 se agotó.
A partir de enero de 2026, Google se trasladó a lanzamientos mensuales de API, cuatro versiones principales anualmente además de pequeñas actualizaciones mensuales con cambios permanentes. Este calendario acelerado significa que tendrás que actualizar al menos dos veces al año en lugar de trimestralmente.
Versiones compatibles actuales:
- v23 (más reciente, enero de 2026)
- v22 (estable, octubre de 2025)
- v21 (septiembre de 2025)
- v20 (agosto de 2025)
Cada versión obtiene aproximadamente 12 meses de soporte tras el lanzamiento de su sucesor. Planifique las migraciones entre 2 y 3 meses antes de la fecha de finalización para evitar problemas de última hora.
Qué se estropea cuando se agota la API v19 de Google Ads
Todas las solicitudes de la versión 19 devuelven errores inmediatos. Sin advertencias, sin período de gracia.
Errores de autenticación incluso con tokens de OAuth válidos. Google rechaza por completo el punto final de la versión 19, tus credenciales funcionan bien, pero la versión de la API ya no existe.
Fallos de «cliente no encontrado» porque la versión 19 utilizaba identificadores de cliente numéricos (1234567890) mientras que la versión 20+ requiere el formato de nombre del recurso (clientes/1234567890).
Fallos silenciosos en algunas herramientas de presentación de informes. En lugar de mensajes de error, obtienes cero filas. Parece una consulta exitosa sin datos, lo que dificulta la depuración.
El tablero se rompe en Looker Studio, Google Sheets, Power BI o en cualquier lugar donde extraigas datos de Google Ads mediante programación.
Algunas integraciones muestran datos parciales para 24-48 horas antes del fracaso total. No asumas que todo está bien solo porque todavía está funcionando el 11 de febrero.
Quién necesita migrar desde la API v19 de Google Ads
Estás afectado si:
- Los scripts personalizados hacen referencia a «v19" en cualquier parte del código
- Las herramientas de terceros muestran la versión 19 de la API de Google Ads en la configuración
- Los informes automatizados dejaron de actualizarse después del 11 de febrero
- Creó integraciones de API internamente
Estás a salvo si:
- Solo usas la interfaz web de Google Ads
- Su conector indica explícitamente que gestiona las migraciones automáticamente
- Usas herramientas administradas que se actualizan automáticamente (consulta con tu proveedor)
Comprobar Consola de Google Cloud → API y servicios → API de Google Ads → Métricas para ver a qué versiones llama tu proyecto.
Cómo migrar a la API v22 de Google Ads
Actualizar las referencias de las versiones de la API
Cambia las URL de los puntos finales en tu código:
// Old (breaks February 11)
https://googleads.googleapis.com/v19/customers/1234567890/googleAdsService
// New
https://googleads.googleapis.com/v22/customers/1234567890/googleAdsService
Actualice las constantes de versión:
// Old
const API_VERSION = 'v19';
// New
const API_VERSION = 'v22';Corregir el formato de identificación del cliente
La versión 20+ requiere el nombre completo del recurso:
// Old format
customerId: '1234567890'
// New format
customerId: 'customers/1234567890'
Este único cambio corrige la mayoría de los errores de «cliente no encontrado» después de la migración.
Revisa los cambios más importantes
De Google guía oficial de migración enumera los cambios en los nombres de los campos, las métricas obsoletas y los nuevos requisitos entre versiones. Presupuesto 1-2 horas leer los cambios que afectan a su implementación específica.
Algunos cambios comunes entre la versión 19 y la versión 22:
- Métricas de anuncios de vídeo con nombre
- Se eliminaron las entidades de feed obsoletas
- Límites de operación por lotes modificados
- Nuevos requisitos de autodeclaración de publicidad política de la UE
Probar primero en entornos fuera de producción
Implemente en una cuenta de prueba o en un cliente de bajo gasto antes de pasar a la producción. Ejecute consultas para al menos 24 horas para detectar problemas intermitentes.
Esté atento a:
- Tiempos de espera de consulta (la versión 22 impone una optimización de consultas más estricta)
- Campos faltantes o renombrados
- Diferentes métodos de cálculo métrico
Obsolescencia del seguimiento de sesiones (problema independiente)
No confundas el cierre de la versión 19 con los cambios en el seguimiento de las sesiones anunciados el 7 de enero de 2026.
2 de febrero de 2026: La API de Google Ads dejó de aceptar nuevas implementaciones de los atributos de sesión y las direcciones IP en las importaciones de conversiones. Los nuevos anunciantes deben usar API de gestión de datos en vez de eso.
Importante: Los usuarios actuales tienen derechos adquiridos. Si ya estás importando atributos de sesión a través de la API de Google Ads, puedes continuar de forma indefinida. La restricción solo afecta a las nuevas implementaciones.
Esto es independiente de la puesta de sol de la v19. El seguimiento de las sesiones afecta a las funciones que puedes implementar, mientras que el cierre de la versión 19 afecta a si el código se ejecuta o no.
Elegir qué versión de la API de Google Ads usar
v23 ofrece el período de soporte más largo (hasta ~ marzo de 2027), pero tiene menos documentación de la comunidad y posibles errores no descubiertos.
v2 es la opción estable actual. Probado exhaustivamente, la mayoría de las herramientas de terceros lo admiten, ampliamente documentado. Ideal para despliegues de producción.
v 21 sigue funcionando, pero tendrá que volver a migrar antes.
La mayoría de los equipos eligen la versión 22 para la migración inmediata y luego programan la actualización de la versión 24 para el tercer trimestre de 2026. Saltarse las versiones está bien, no es necesario migrar todas las versiones intermedias.
Si la integración de la API de Google Ads ya no funciona
¿Los scripts están fallando ahora mismo?
- Busca referencias a la versión 19 en tu código (busca «versión 19», «googleads.googleapis.com/v19»)
- Actualización a v22
- Corregir el formato de identificación del cliente (añadir el prefijo «customers/»)
- Implemente en una cuenta de prueba
- Supervise 24 horas antes de la implementación completa
Los cambios de código tienen lugar 15-30 minutos. Las pruebas llevan más tiempo, pero evitan que se rompan todas tus cuentas simultáneamente.
Para las conexiones de Google Sheets específicamente, consulta nuestra guía sobre conectar Google Ads a Google Sheets que abarca tanto los métodos nativos como los enfoques automatizados.
Comprender la evolución de la API de Google Ads
Google ha estado impulsando a los desarrolladores hacia la nueva arquitectura de API de anuncios desde 2018. La antigua API de AdWords dejó de funcionar por completo abril de 2022. Si todavía estás entendiendo las diferencias, nuestro Comparación entre la API de Google Ads y la API de AdWords desglosa los principales cambios arquitectónicos.
Próxima caducidad de la API de Google Ads: 2027
Sea cual sea la versión a la que migre hoy, con el tiempo se extinguirá. Rastrea al oficial calendario de desaprobación y establece recordatorios de calendario trimestrales.
Puestas de sol futuras aproximadas:
- v22: ~Febrero de 2027
- v23: ~ marzo de 2027
- v24: ~Abril de 2027
El calendario de lanzamientos mensuales implica migraciones más frecuentes pero más pequeñas. Es mejor que el antiguo sistema trimestral, en el que se acumulaban cambios importantes.
Preguntas frecuentes
¿Puedo obtener una prórroga después del 11 de febrero?
No. El apagado es automático y se aplica en todo el mundo.
¿Afecta esto a la interfaz web de Google Ads?
No. Solo se ve afectado el acceso programático a la API.
¿Se eliminarán los datos históricos?
No. Los datos de tu cuenta de Google Ads permanecen intactos. Solo el punto final de la API v19 deja de funcionar.
¿Qué pasa si mi herramienta de informes usa la versión 19?
Ponte en contacto con su servicio de asistencia. La mayoría de los proveedores ya deberían haber migrado. Si no lo han hecho, considera la posibilidad de cambiarte a un proveedor que cumpla con el calendario de obsolescencias de Google.
¿Tengo que migrar a través de todas las versiones?
No. Puedes pasar directamente de la v19 a la v22 o a la v23.
