Baja y descontinuación

Con el lanzamiento de una versión nueva, se establece una fecha de descontinuación para la versión obsoleta, después de la cual ya no estará disponible. Estas son algunas otras directrices que debes tener en cuenta:

• Nos esforzamos por mantener disponibles un máximo de cinco versiones principales en cualquier momento.
• Las versiones principales tienen una vida útil de alrededor de 12 meses y las versiones secundarias de 10 meses.
• Tendrás que realizar un máximo de dos actualizaciones por año y no es necesario que lo hagas en un orden secuencial estricto. Por ejemplo, puedes actualizar de la versión (N) directamente a la versión (N+2).

Nuestras bibliotecas cliente admiten cualquier versión disponible de un servicio, por lo que puedes actualizar de forma gradual especificando diferentes versiones de los servicios utilizados.

Horario

En la siguiente tabla, se enumeran las fechas específicas de baja y descontinuación para cada versión disponible, así como las fechas de lanzamiento previstas para las versiones futuras. Te recomendamos que actualices a la versión más reciente lo antes posible después de su lanzamiento. La fecha tentativa significa que la descontinuación podría ocurrir en cualquier momento de ese mes y que las fechas podrían cambiar. Suscríbete al blog para recibir recordatorios de anuncios de descontinuación de versiones de la API.

Versión de API	Fecha de lanzamiento	Fecha de descontinuación	Guía de actualización
Versiones actualizadas
v21	6 de agosto de 2025	Agosto de 2026 (tentativa)	Actualización de v20 a v21
v22	15 de octubre de 2025	Octubre de 2026 (tentativa)	Actualización de v21 a v22
v23	28 de enero de 2026	Febrero de 2027	Actualización de v22 a v23
v23.1	25 de febrero de 2026	Febrero de 2027	Actualización de v23 a v23.1
v23.2	25 de marzo de 2026	Febrero de 2027	Actualización de v23.1 a v23.2
v24	22 de abril de 2026	Mayo de 2027	Actualización de v23.2 a v24
v24.1	13 de mayo de 2026	Mayo de 2027	Actualización de v24 a v24.1
v24.2	24 de junio de 2026	Junio de 2027	Actualización de v24.1 a v24.2
Próximas versiones
v25	Julio de 2026	Agosto de 2027
v25.1	Agosto de 2026	Agosto de 2027
v25.2	Septiembre de 2026	Agosto de 2027
v26	Octubre de 2026	Noviembre de 2027
v26.1*	Noviembre de 2026	Noviembre de 2027

* La versión v26.1 se designa como una versión opcional debido a la superposición con la temporada de fiestas.

Cómo ver las versiones que usa tu proyecto

Puedes ver una lista de los métodos y servicios que tu proyecto llamó recientemente con la consola de Google Cloud:

1. Abre APIs y servicios en la consola de Google Cloud.
2. Haz clic en API de Google Ads en la tabla.
3. En la subpestaña MÉTRICAS, deberías ver tus solicitudes recientes representadas en cada gráfico. Puedes ver a qué métodos enviaste solicitudes en la tabla Métodos. El nombre del método incluye una versión de la API de Google Ads, un servicio y un nombre de método, como google.ads.googleads.v24.services.GoogleAdsService.Mutate.
4. (Opcional) Elige el período que deseas ver para tus solicitudes.

Diferencias entre baja y descontinuación

Término	Baja	Descontinuación
Definición	La versión obsoleta es una versión que no es la más reciente. Una vez que se lanza una versión nueva, todas las versiones anteriores se marcarán como obsoletas.	La versión descontinuada ya no se puede usar. Las solicitudes enviadas a esta versión fallarán a partir de la fecha de descontinuación.
Implicancia	Puedes seguir usando las versiones obsoletas hasta que se descontinúen, pero las referencias de las versiones obsoletas se desmarcan para mostrar que ya no son la versión más reciente. Te recomendamos que actualices a la versión más reciente lo antes posible para aprovechar las funciones nuevas.	Debes actualizar desde las versiones descontinuadas de inmediato para usar la API de Google Ads. Te recomendamos que actualices a la versión más reciente con la guía de actualización.
Tiempos	En promedio, lanzamos una versión nueva cada 3 o 4 meses, por lo que la versión determinada quedará obsoleta después de aproximadamente 3 o 4 meses.	Nuestro objetivo es descontinuar una versión 1 año después de su lanzamiento.
API	Los extremos de la API para las versiones obsoletas siguen funcionando como de costumbre. Puedes acceder a nuestros extremos de la API con nuestras bibliotecas cliente y REST. Sin embargo, no se agregan funciones nuevas a las versiones obsoletas.	Los extremos de la API para las versiones descontinuadas dejan de funcionar después de las fechas de descontinuación. La API de Google Ads mostrará un error si intentas acceder a los extremos de la API de las versiones descontinuadas.
Bibliotecas cliente	Para proporcionar bibliotecas cliente compactas, dejaremos de incluir versiones obsoletas de la API en una versión nueva de la biblioteca cliente después de la fecha de baja. Esto te ayuda a ahorrar espacio cuando incorporas nuestras bibliotecas cliente en tus proyectos.	Las bibliotecas cliente ya no admiten las versiones descontinuadas de la API en cualquier versión nueva de la biblioteca cliente después de las fechas de descontinuación.
Asistencia	Brindamos asistencia periódica para las versiones obsoletas.	Las versiones descontinuadas ya no son compatibles después de la fecha de descontinuación.

Versiones de bibliotecas cliente compatibles

En la tabla, se muestra qué bibliotecas cliente funcionan con qué versiones de la API.

La versión mínima de la biblioteca cliente que se muestra es suficiente para la versión principal de la API de Google Ads (como v24). Para ver la versión de la biblioteca cliente requerida para las versiones secundarias, consulta el registro de cambios vinculado.

Bajas y cambios de funciones

Si bien esta página se centra en los ciclos de vida a nivel de la versión de la API, las bajas de funciones individuales (como la baja de las Campañas inteligentes) y los cambios en el flujo de trabajo sin versiones (como los nuevos requisitos de presupuesto de las campañas de Generación de demanda) se registran por separado.

Para consultar los próximos ciclos de vida de las funciones y los cambios de comportamiento en las versiones activas, consulta la guía Bajas de funciones y cambios sin versiones.