Con el lanzamiento de una versión nueva, se asigna una fecha de eliminación a la versión obsoleta, después de la cual esa versión ya no estará disponible. A continuación, se incluyen otros lineamientos 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, mientras que las versiones secundarias tienen una vida útil de 10 meses.
- 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).
Nuestras bibliotecas cliente admiten cualquier versión disponible de un servicio, por lo que puedes actualizarlo de forma gradual especificando diferentes versiones de los servicios utilizados.
Horario
En la siguiente tabla, se indican las fechas específicas de baja y descontinuación de cada versión disponible, así como las fechas de lanzamiento proyectadas 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 | Guía de actualización |
|---|---|---|---|
| Versiones de actualización | |||
| v22 | 15 de octubre de 2025 | Octubre de 2026 | Actualiza de la versión 21 a la 22 |
| v23 | 28 de enero de 2026 | Febrero de 2027 | Actualiza de la versión 22 a la 23 |
| v23.1 | 25 de febrero de 2026 | Febrero de 2027 | Actualiza de la versión 23 a la 23.1 |
| v23.2 | 25 de marzo de 2026 | Febrero de 2027 | Actualiza de la versión 23.1 a la 23.2 |
| v24 | 22 de abril de 2026 | Mayo de 2027 | Actualiza de la versión 23.2 a la 24 |
| v24.1 | 13 de mayo de 2026 | Mayo de 2027 | Actualiza de la versión 24 a la 24.1 |
| v24.2 | 24 de junio de 2026 | Junio de 2027 | Actualiza de la versión 24.1 a la 24.2 |
| v25 | 22 de julio de 2026 | Agosto de 2027 | Actualiza de la versión 24.2 a la 25 |
| v25.1 | 19 de agosto de 2026 | Agosto de 2027 | Actualiza de la versión 25 a la 25.1 |
| v25.2 | 23 de septiembre de 2026 | Agosto de 2027 | Actualiza de la versión 25.1 a la 25.2 |
| Próximas versiones | |||
| v26 | Octubre de 2026 | Noviembre de 2027 | |
| v26.1 | Octubre de 2026 | Noviembre de 2027 | |
| v26.2 | Noviembre de 2026 | Noviembre de 2027 | |
| 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 versiones opcionales debido a la superposición 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:
- Abre APIs & Services en la consola de Google Cloud.
- Haz clic en API de Google Ads en la tabla.
- 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.v25.services.GoogleAdsService.Mutate. - (Opcional) Elige el período que deseas ver para tus solicitudes.
Diferencias entre baja y descontinuación
| Término | Baja | Atardecer |
|---|---|---|
| Definición | La versión obsoleta es una versión que no es la más reciente. Una vez que se lance una versión nueva, todas las versiones anteriores se marcarán como obsoletas. | 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 nuevas funciones. |
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 | 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 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 API de las versiones dadas de baja. |
| Bibliotecas cliente | Para proporcionar bibliotecas cliente compactas, dejaremos de incluir las 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 | Brindamos asistencia periódica para las versiones descontinuadas. | Luego de la fecha de eliminación, ya no se admitirán las versiones eliminadas. |
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 v25). Para ver la versión de la biblioteca cliente requerida para las versiones secundarias, consulta el registro de cambios vinculado.
Java
API de Google Ads |
Biblioteca cliente para Java |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
API de Google Ads |
Biblioteca cliente para .NET |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
API de Google Ads |
Biblioteca cliente para PHP |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
API de Google Ads |
Biblioteca cliente para Python |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
API de Google Ads |
Biblioteca cliente para Ruby |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
API de Google Ads |
Biblioteca cliente para Perl |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
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.