Baja y descontinuación

Con el lanzamiento de una nueva versión, se le asigna una fecha de eliminación a la versión obsoleta, después de la cual ya no estará disponible. 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, mientras que las versiones secundarias tienen una vida útil 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 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 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 sobre los anuncios de descontinuación de las versiones de la API.

Versión de API	Fecha de lanzamiento	Fecha de baja	Guía de actualización
Versiones de actualización
v20	7 de junio de 2023	10 de junio de 2026	Actualiza de la versión 19 a la 20
v20.1	6 de agosto de 2025	Junio de 2026 (tentativo)	Actualiza de la versión 19 a la 20
v21	6 de agosto de 2025	Agosto de 2026 (tentativo)	Actualiza de la versión 20 a la 21
v22	15 de octubre de 2025	Octubre de 2026 (tentativo)	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
Próximas versiones
v24.2	Junio de 2026	Mayo de 2027
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 26.1 se designa como una versión opcional debido a la superposición con la temporada de festividades.

Cómo ver las versiones que usa tu proyecto

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

1. Abre APIs & Services 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. 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.v24.services.GoogleAdsService.Mutate.
4. (Opcional) Elige el período para el que deseas ver 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 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 de las versiones que dejaron de estar disponibles 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 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 indicada 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 descontinuadas siguen funcionando como de costumbre. Puedes acceder a nuestros extremos de API con nuestras bibliotecas cliente y REST. Sin embargo, no se agregan funciones nuevas a las versiones obsoletas.	Los extremos de la API de las versiones desactivadas 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 extremos de la API de las versiones desactivadas.
Bibliotecas cliente	Para proporcionar bibliotecas cliente compactas, dejaremos de incluir versiones de 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 que se retiraron en ninguna versión nueva de la biblioteca cliente después de las fechas de retiro.
Asistencia	Brindamos asistencia periódica para las versiones obsoletas.	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.

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 específicas de funciones que se planean para la API de Google Ads. En las publicaciones de blog vinculadas, puedes encontrar más detalles sobre cada baja.

Función	Descripción	Fecha de entrada en vigencia	Notas adicionales
Cambio en la política de retención de datos	El período de retención de los datos de informes detallados (diarios, por hora y semanales) se reducirá a 37 meses. Los datos generales (mensuales, trimestrales y anuales) seguirán disponibles durante 11 años.	1 de junio de 2026	Consulta nuestra entrada de blog para obtener más detalles.
Cambios en la asistencia con las conversiones sin conexión	A partir del 15 de junio de 2026, los tokens de desarrollador sin solicitudes recientes de conversiones sin conexión deberán usar la API de Data Manager para sus flujos de trabajo de conversiones sin conexión. Si tu token de desarrollador envió una solicitud de UploadClickConversions entre el 17 de diciembre de 2025 y el 15 de junio de 2026, puedes seguir usándolo con la API de Google Ads para los flujos de trabajo de conversiones sin conexión. Sin embargo, te recomendamos que actualices tus flujos de trabajo de conversiones sin conexión a la API de Data Manager para obtener una mejor experiencia del desarrollador y acceder a funciones adicionales. De lo contrario, a partir del 15 de junio de 2026, cualquier solicitud de UploadClickConversions fallará con el error CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE. Usa la API de Data Manager para tus flujos de trabajo de conversiones sin conexión en lugar de la API de Google Ads.	15 de junio de 2026	Consulta nuestra entrada de blog para obtener más detalles.
Cambios en la compatibilidad con la Segmentación por clientes	A partir del 1 de abril de 2026, los tokens de desarrollador sin solicitudes recientes de Segmentación por clientes deberán usar la API de Data Manager para sus flujos de trabajo de Segmentación por clientes. Si tu token de desarrollador envió una solicitud de OfflineUserDataJobService o UserDataService para los públicos de Segmentación por clientes entre el 1 de octubre de 2025 y el 31 de marzo de 2026, puedes seguir usando tu token de desarrollador con la API de Google Ads para los flujos de trabajo de Segmentación por clientes. Sin embargo, te recomendamos que actualices tus flujos de trabajo de Segmentación por clientes a la API de Data Manager para mejorar la experiencia del desarrollador y acceder a funciones adicionales. De lo contrario, a partir del 1 de abril de 2026, fallará cualquier solicitud de públicos de Segmentación por clientes de OfflineUserDataJobService o UserDataService con el error CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE. Usa la API de Data Manager para tus flujos de trabajo de Segmentación por clientes en lugar de la API de Google Ads.	1 de abril de 2026	Consulta nuestra entrada de blog para obtener más detalles.
Cambios en la compatibilidad con la dirección IP y los atributos de sesión	La API de Google Ads ya no acepta usuarios nuevos de los atributos de sesión ni los datos de la dirección IP como parte de las importaciones de conversiones. Los usuarios existentes deben migrar a la API de Data Manager.	2 de febrero de 2026	Consulta nuestra entrada de blog para obtener más detalles.
Baja de los anuncios solo de llamada	No se pueden crear anuncios solo de llamada nuevos. Los anuncios solo de llamada existentes dejarán de publicarse en febrero de 2027 y se quitará la compatibilidad con la API. En su lugar, los anunciantes deben usar anuncios de búsqueda responsivos con recursos de llamada.	Enero de 2026	Consulta nuestra entrada de blog para obtener más detalles.