Baja y descontinuación

La API de Google Ads mantiene varias versiones principales activas en cualquier momento, y una versión se considera obsoleta solo si se marca explícitamente como tal. Publicamos las fechas de lanzamiento y de baja con anticipación para ayudarte a planificar las actualizaciones. Después de la fecha de eliminación de una versión, esta ya no estará disponible. Aquí encontrarás algunos lineamientos clave de control de versiones que debes tener en cuenta:

• Nos esforzamos por mantener un máximo de cinco versiones principales disponibles en cualquier momento.
• Las versiones principales tienen una vida útil de alrededor de 12 meses. No se hace un seguimiento por separado de la vida útil de las versiones secundarias de la API. En cambio, las versiones secundarias comparten la misma fecha de baja que su versión principal correspondiente.
• Cada versión secundaria actualiza de forma incremental su versión principal correspondiente.
• Todas las llamadas a la API a una versión principal específica siempre se dirigen a la versión secundaria correspondiente más reciente. La API de Google Ads no admite llamadas a versiones secundarias específicas.
• Tendrás que realizar, como máximo, dos actualizaciones por año, y no es necesario que actualices en un orden secuencial estricto; por ejemplo, puedes actualizar de la versión (N) directamente a la versión (N+2).
• Si es la primera vez que usas la API de Google Ads, te recomendamos que comiences con la versión 26.

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 indican las fechas de lanzamiento y de baja de 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 el cierre 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 desactivación de versiones de la API.

Versión de API	Fecha de lanzamiento	Fecha de descontinuación	Cambios rotundos y actualización	Funciones y actualizaciones	Tabla de diferencias de proto
Versiones de actualización
v23	28 de enero de 2026	Febrero de 2027	Cambios rotundos de la versión 23 (guía de actualización)	Funciones y actualizaciones de la versión 23	Diferencias entre los protos de la versión 22 y la versión 23
v23.1	25 de febrero de 2026	Febrero de 2027	Ninguna (versión secundaria)	Funciones y actualizaciones de la versión 23.1	Diferencias entre los protos de la versión 22 y la versión 23
v23.2	25 de marzo de 2026	Febrero de 2027	Ninguna (versión secundaria)	Funciones y actualizaciones de la versión 23.2	Diferencias entre los protos de la versión 22 y la versión 23
v23.3	24 de junio de 2026	Febrero de 2027	Ninguna (versión secundaria)	Funciones y actualizaciones de la versión 23.3	Diferencias entre los protos de la versión 22 y la versión 23
v24	22 de abril de 2026	Mayo de 2027	Cambios rotundos de la versión 24 (guía de actualización)	Funciones y actualizaciones de la versión 24	Diferencias entre los protos de la v23 y la v24
v24.1	13 de mayo de 2026	Mayo de 2027	Ninguna (versión secundaria)	Funciones y actualizaciones de la versión 24.1	Diferencias entre los protos de la v23 y la v24
v24.2	24 de junio de 2026	Junio de 2027	Ninguna (versión secundaria)	Funciones y actualizaciones de la versión 24.2	Diferencias entre los protos de la v23 y la v24
v25	22 de julio de 2026	Agosto de 2027	Cambios rotundos de la versión 25 (guía de actualización)	Funciones y actualizaciones de la versión 25	Diferencias entre los protos de la versión 24 y la versión 25
v25.1	19 de agosto de 2026	Agosto de 2027	Ninguna (versión secundaria)	Funciones y actualizaciones de la versión 25.1	Diferencias entre los protos de la versión 24 y la versión 25
v25.2	23 de septiembre de 2026	Agosto de 2027	Ninguna (versión secundaria)	Funciones y actualizaciones de la versión 25.2	Diferencias entre los protos de la versión 24 y la versión 25
v26 (Más reciente)	14 de octubre de 2026	Noviembre de 2027	Cambios rotundos de la versión 26 (guía de actualización)	Funciones y actualizaciones de la versión 26	Diferencias entre los protos v25 y v26
v26.1	28 de octubre de 2026	Noviembre de 2027	Ninguna (versión secundaria)	Funciones y actualizaciones de la versión 26.1	Diferencias entre los protos v25 y v26
v26.2	11 de noviembre de 2026	Noviembre de 2027	Ninguna (versión secundaria)	Funciones y actualizaciones de la versión 26.2	Diferencias entre los protos v25 y v26
Próximas versiones
v26.3*	December 2026	Noviembre de 2027
v27	Enero de 2027	Febrero de 2028
v27.1	Febrero de 2027	Febrero de 2028
v27.2	Febrero de 2027	Febrero de 2028
v27.3	Marzo de 2027	Febrero de 2028
v27.4	Marzo de 2027	Febrero de 2028
v28	Abril de 2027	Mayo de 2028
v28.1	Abril de 2027	Mayo de 2028
v28.2	Mayo de 2027	Mayo de 2028
v28.3	Mayo de 2027	Mayo de 2028
v28.4	Junio de 2027	Mayo de 2028
v28.5	Junio de 2027	Mayo de 2028
v29	Julio de 2027	Agosto de 2028
v29.1	Julio de 2027	Agosto de 2028
v29.2	Agosto de 2027	Agosto de 2028
v29.3	Agosto de 2027	Agosto de 2028
v29.4	Septiembre de 2027	Agosto de 2028
v29.5	Septiembre de 2027	Agosto de 2028
v30	Octubre de 2027	Noviembre de 2028
v30.1	Octubre de 2027	Noviembre de 2028
v30.2	Noviembre de 2027	Noviembre de 2028
v30.3*	Diciembre de 2027	Noviembre de 2028

* Las versiones v26.3 y v30.3 se designan como opcionales debido a que se superponen con la temporada de festividades.

Consulta las versiones que usa tu proyecto

Puedes ver una lista de los métodos y servicios a los 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 pestaña secundaria MÉTRICAS, deberías ver tus solicitudes recientes trazadas 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.v26.services.GoogleAdsService.Mutate.
4. (Opcional) Elige el período que deseas ver para tus solicitudes.

Diferencias entre baja y descontinuación

Término	Baja	Atardecer
Definición	Una versión se considera obsoleta solo si se marca de forma explícita como obsoleta. La API de Google Ads tiene varias versiones principales activas en cualquier momento.	La versión eliminada ya no se puede usar. Las solicitudes enviadas a esta versión fallarán en la fecha de desactivación o después de ella.
Implicancia	Puedes seguir usando las versiones obsoletas hasta que se retiren, 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 las versiones que dejarán de estar disponibles de inmediato para poder usar la API de Google Ads. Te recomendamos que actualices a la versión más reciente con la guía de actualización.
Duración	Las fechas de baja se publican con anticipación, y una versión se considera obsoleta solo si se marca explícitamente como tal.	Nuestro objetivo es dar de baja una versión 1 año después de su lanzamiento.
API	Los endpoints de API para las versiones obsoletas siguen funcionando como de costumbre. Puedes acceder a nuestros endpoints de API con nuestras bibliotecas cliente y REST. Sin embargo, no se agregan funciones nuevas a las versiones obsoletas.	Los endpoints de API para las versiones que se desactivarán dejarán de funcionar después de las fechas de desactivación. La API de Google Ads arrojará un error si intentas acceder a los endpoints de la API de las versiones dadas de baja.
Bibliotecas cliente	Para proporcionar bibliotecas cliente compactas, dejaremos de incluir versiones de la API obsoletas en una nueva versión 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 de la API eliminadas en ninguna versión nueva de la biblioteca cliente después de las fechas de eliminación.
Asistencia	Proporcionamos asistencia periódica para las versiones obsoletas.	Las versiones eliminadas ya no se admiten después de la fecha de eliminación.

Versiones compatibles de la biblioteca cliente

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 indica es suficiente para la versión principal de la API de Google Ads (como la v26). 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 enfoca 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 versión (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 versión.