Baja y descontinuación

Con el lanzamiento de una nueva versión, se les asigna una fecha de eliminación a las versiones obsoletas, después de la cual ya no estarán disponibles. A continuación, se incluyen otros lineamientos que debes tener en cuenta:

  • Nos esforzamos por mantener disponibles, como máximo, cuatro versiones principales en cualquier momento.
  • Las versiones principales tienen una vida útil de alrededor de 12 meses, y las versiones secundarias, de 10 meses.
  • Deberás realizar, como máximo, dos actualizaciones por año, y no es necesario que las realices en un orden secuencial estricto. Por ejemplo, puedes actualizar de la versión (N) directamente a la versión (N+2).
  • La superposición entre la fecha en la que se lanzan todas las bibliotecas cliente para la versión más reciente y la versión que se descontinuará es de al menos 20 semanas.

Nuestras bibliotecas cliente admiten cualquier versión disponible de un servicio, por lo que puedes actualizar gradualmente 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, y 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 sobre los anuncios de desactivación de versiones de la API.

Versión de APIFecha de lanzamientoFecha de bajaFecha de descontinuaciónGuía de actualización
v216 de agosto de 2025Actualiza de la versión 20 a la 21
v20.16 de agosto de 2025Junio de 2026 (tentativo)Actualiza de la versión 19 a la 20
v204 de junio de 2025Junio de 2026 (tentativo)Actualiza de la versión 19 a la 20
v19.26 de agosto de 2025 Febrero de 2026 (tentativo)Actualiza de la versión 18 a la 19
v19.116 de abril de 2025 Febrero de 2026 (tentativo)Actualiza de la versión 18 a la 19
v1926 de febrero de 2025 Febrero de 2026 (tentativo)Actualiza de la versión 18 a la 19
v1816 de octubre de 2024Junio de 202520 de agosto de 2025

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 Google Cloud Console:

  1. Abre APIs & Services en la consola de Google Cloud.
  2. Haz clic en Google Ads API en la tabla.
  3. En la subpestaña MÉTRICAS, deberías ver tus solicitudes recientes representadas en cada gráfico. En la tabla Métodos, puedes ver a qué métodos enviaste solicitudes. 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.v21.services.GoogleAdsService.Mutate.
  4. (Opcional) Elige el período para el que deseas ver tus solicitudes.

Diferencias entre baja y descontinuación

TérminoBajaAtardecer
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. Ya no se puede usar la versión eliminada. Las solicitudes enviadas a esta versión fallarán a partir de la fecha de eliminación.
Implicación Aún puedes usar las versiones que dejaron de estar disponibles hasta que se descontinúen, pero las referencias a esas versiones se desmarcan para mostrar que ya no son las más recientes.

Te recomendamos que actualices a la versión más reciente lo antes posible para aprovechar las nuevas funciones.

 Debes actualizar 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.
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 API para las versiones en desuso siguen funcionando como de costumbre.

Puedes acceder a nuestros extremos de API con nuestras bibliotecas cliente, REST, etcétera. Sin embargo, no se agregan funciones nuevas a las versiones obsoletas.

 Los extremos de API de las versiones desactivadas dejan de funcionar después de las fechas de desactivació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 las versiones de la API que estén 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 que se dieron de baja en ninguna versión nueva de la biblioteca cliente después de las fechas de baja.
Asistencia Brindamos asistencia periódica para las versiones descontinuadas. Las versiones retiradas ya no son compatibles después de la fecha de retiro.

Versiones de bibliotecas cliente compatibles

En la tabla, se muestran las bibliotecas cliente que funcionan con cada versión de la API.

Java

Biblioteca cliente para Java
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -

C#

Biblioteca cliente para .NET
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: 23.0.0

PHP

Biblioteca cliente para PHP
v21 Min: 31.0.0
Max: -
v20 Min: 28.0.0
Max: -
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: 30.0.0

Python

Biblioteca cliente para Python
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -

Ruby

Biblioteca cliente para Ruby
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -
v18 Min: 31.0.0
Max: -

Perl

Biblioteca cliente para Perl
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: 28.0.0

Bajas de funciones

Supervisa periódicamente el blog para desarrolladores de Google Ads para ser el primero en enterarte de las próximas bajas de funciones.

En la siguiente tabla, se enumeran las bajas de funciones específicas que se planean para la API de Google Ads. En las entradas de blog vinculadas, puedes encontrar más detalles sobre cada baja.

Función Descripción Fecha de entrada en vigencia Notas adicionales
Entorno de conversión que afecta el rendimiento de la campaña de aplicaciones A partir del 30 de septiembre de 2025, comenzaremos a lanzar gradualmente un cambio en los modelos de ofertas, lo que les permitirá usar los datos del entorno de conversión incluidos en las conversiones importadas para optimizar el rendimiento de las campañas. 3 de octubre de 2025 Consulta nuestra entrada de blog para obtener más detalles.
Las conversiones pueden incluir valores de `gclid` y `gbraid`. A partir del 3 de octubre de 2025, las conversiones importadas ya no mostrarán un error de `VALUE_MUST_BE_UNSET` si se configuran los campos `gclid` y `gbraid`. 3 de octubre de 2025 Consulta nuestra entrada de blog para obtener más detalles.