Baja y desactivación

Cuando se lanza una nueva versión, a una versión obsoleta se le asigna una fecha de desactivación, después de la cual dejará de estar disponible. Estos son otros lineamientos que debes tener en cuenta:

  • Como máximo, hay tres versiones principales disponibles a la vez.
  • Las versiones principales tienen una vida útil de alrededor de 12 meses y las 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 de baja y desactivación específicas de cada versión disponible, y 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.

Versión de APIFecha de lanzamientoFecha de bajaFecha de desactivaciónGuía de actualización
v1926 de febrero de 2025 Actualiza de la versión 18 a la 19
v1816 de octubre de 2024Junio de 2025Septiembre de 2025Actualiza de la versión 17 a la 18
17.17 de agosto de 202416 de octubre de 20244 de junio de 2025
v175 de junio de 202416 de octubre de 20244 de junio de 2025

Cómo ver las versiones que usa tu proyecto

Puedes ver una lista de los métodos y servicios a los que llamó tu proyecto 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 METRICS, 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.v19.services.GoogleAdsService.Mutate.
  4. (Opcional) Elige el período que deseas ver para tus solicitudes.

Diferencias entre baja y desactivació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 de desactivación. Las solicitudes que se envíen a esta versión fallarán a partir de la fecha de desactivación.
Implicancia Puedes seguir usando las versiones obsoletas hasta que se desactiven, pero las referencias de las versiones obsoletas dejarán de estar destacadas 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 beneficiarte de las funciones nuevas.

 Debes actualizar desde las versiones de desactivación 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 dejará de estar disponible después de aproximadamente 3 o 4 meses. Nuestro objetivo es dar de baja una versión 1 año después de su lanzamiento.
API Los extremos de API de las versiones obsoletas 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 que dejarán de estar disponibles dejarán 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 que dejarán de estar disponibles.
Bibliotecas cliente Para proporcionar bibliotecas cliente compactas, dejaremos de incluir las versiones de API obsoletas 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 de API eliminadas en ninguna versión nueva de biblioteca cliente después de las fechas de eliminación.
Asistencia Proporcionamos asistencia periódica para las versiones obsoletas. Las versiones eliminadas ya no son compatibles después de la fecha de eliminación.

Versiones de bibliotecas cliente compatibles

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

Java

Biblioteca cliente para Java
v19 Min: 36.0.0
Max: -
v18 Min: 34.0.0
Max: -
v17 Min: 32.0.0
Max: -

C#

Biblioteca cliente para .NET
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: -
v17 Min: 20.1.0
Max: -
v16 Min: 18.1.0
Max: 21.1.0

PHP

Biblioteca cliente para PHP
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: -
v16 Min: 22.1.0
Max: -

Python

Biblioteca cliente para Python
v19 Min: 25.2.0
Max: -
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -

Ruby

Biblioteca cliente para Ruby
v18 Min: 31.0.0
Max: -
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -

Perl

Biblioteca cliente para Perl
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: -
v17 Min: 23.0.0
Max: -

Bajas de funciones

Supervisa con frecuencia 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 planificaron para la API de Google Ads. Puedes encontrar más detalles sobre cada baja en las entradas de blog vinculadas.

Función Descripción Fecha de entrada en vigencia Notas adicionales
Actualización del informe de estadísticas de términos de búsqueda de la API de Google Ads y las secuencias de comandos de Google Ads a partir del 3 de marzo de 2025 A partir del 3 de marzo de 2025, los informes de estadísticas de términos de búsqueda de la API de Google Ads y las secuencias de comandos de Google Ads mostrarán todas las subcategorías de búsqueda como vacías. La IU de Google Ads ya quitó este campo, y la API también lanzará este cambio para que sea coherente en Google Ads. 3 de marzo de 2025 A partir del 3 de marzo de 2025, se espera que todos los valores de segments.search_subcategory estén vacíos. Si consultas segments.search_subcategory en los informes campaign_search_term_insight o customer_search_term_insight, verifica que tu código pueda controlar un valor vacío en segments.search_subcategory. Una cadena vacía ya es un todo incluido, por lo que tu código ya debería controlar esto. Te recomendamos que quites segments.search_subcategory de tu consulta.
Próximos cambios en el tamaño de la página en la API de Google Ads Cuando se desactive la versión 16, ya no podrás configurar el campo page_size cuando realices solicitudes GoogleAdsService.Search. Febrero de 2025 Cuando se desactive la versión 16, todas las solicitudes de GoogleAdsService.Search tendrán un tamaño de página fijo de 10,000 filas.
Actualización sobre el vencimiento de las membresías de la Segmentación por clientes A partir del 7 de abril de 2025, el campo UserList.membership_life_span ya no permitirá valores superiores a 540. 7 de abril de 2025 Entre el 7 y el 15 de abril de 2025, lanzaremos gradualmente un cambio en el campo UserList.membership_life_span. Las solicitudes para establecer el campo en un valor superior a 540 mostrarán un error RangeError.TOO_HIGH. Cualquier lista de usuarios existente con un valor de campo superior a 540 se migrará automáticamente para tener una duración de membresía de 540 días como máximo. Consulta Actualización sobre el vencimiento de las membresías de la Segmentación por clientes para obtener más información.