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. A continuación, se incluyen otras pautas que debes tener en cuenta:
- Como máximo, hay tres versiones principales disponibles en cualquier momento.
- Las versiones principales tienen una vida útil de alrededor de 12 meses y las secundarias, de 10 meses.
- Tendrás que realizar como máximo dos actualizaciones por año sin que debas realizar la actualización en estricto orden secuencial; 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 lanzaron todas las bibliotecas cliente para la versión más reciente y la 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 desactivación de cada versión disponible, así como las fechas de lanzamiento proyectadas para versiones futuras. Te recomendamos que actualices a la versión más reciente lo antes posible tras su lanzamiento.
Versión de API | Fecha de lanzamiento | Fecha de baja | Fecha de descontinuación | Guía de actualización |
---|---|---|---|---|
v18 | 16 de octubre de 2024 | Febrero de 2025 | 24 de septiembre de 2025 | |
v17.1 | 7 de agosto de 2024 | Sep/oct de 2024 | 4 de junio de 2025 | Actualiza de la versión 17 a la 18 |
v17 | 5 de junio de 2024 | Sep/oct de 2024 | 4 de junio de 2025 | Actualización de la versión 17 a la 18 |
v16.1 | 24 de abril de 2024 | 5 de junio de 2024 | 5 de febrero de 2025 | Actualización de la versión 16 a la 17 |
v16 | 21 de febrero de 2024 | 5 de junio de 2024 | 5 de febrero de 2025 | Actualización de la versión 16 a la 17 |
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 mediante la consola de Google Cloud:
- Abre APIs y servicios en la consola de Google Cloud.
- Haz clic en API de Google Ads en la tabla.
- 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.v18.services.GoogleAdsService.Mutate
. - (Opcional) Elige el período que deseas ver para tus solicitudes.
Diferencias entre la baja y la descontinuación
Término | Baja | Atardecer |
---|---|---|
Definición | La versión obsoleta es una 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 descontinuada. Las solicitudes que se envíen a esta versión fallarán a partir de la fecha de desactivación. |
Implicancia | Puedes usar las versiones obsoletas hasta que se descontinúen, pero las referencias de las versiones obsoletas se quitan 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 realizar la actualización desde las versiones descontinuadas de inmediato para
poder usar la API de Google Ads.
Te recomendamos que actualices a la versión más reciente mediante 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 retirar la versión 1 año después del lanzamiento. |
API | Los extremos de la API para 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 la API para las versiones de desactivación dejan de funcionar después de esas fechas. 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 | Ofrecemos asistencia periódica para las versiones obsoletas. | Las versiones eliminadas ya no son compatibles después de la fecha de eliminación. |
Versiones compatibles de bibliotecas cliente
La tabla muestra qué bibliotecas cliente funcionan con qué versiones de API.
Java
API de Google Ads |
Biblioteca cliente para Java |
v18 |
Min: 34.0.0 Max: - |
v17 |
Min: 32.0.0 Max: - |
v16 |
Min: 30.0.0 Max: - |
C#
API de Google Ads |
Biblioteca cliente para .NET |
v18 |
Min: 21.1.0 Max: - |
v17 |
Min: 20.1.0 Max: - |
v16 |
Min: 18.1.0 Max: - |
PHP
API de Google Ads |
Biblioteca cliente para PHP |
v18 |
Min: 25.0.0 Max: - |
v17 |
Min: 23.1.0 Max: - |
v16 |
Min: 22.1.0 Max: - |
Python
API de Google Ads |
Biblioteca cliente para Python |
v18 |
Min: 25.1.0 Max: - |
v17 |
Min: 24.1.0 Max: - |
v16 |
Min: 23.1.0 Max: - |
Ruby
API de Google Ads |
Biblioteca cliente para Ruby |
v18 |
Min: 31.0.0 Max: - |
v17 |
Min: 29.0.0 Max: - |
v16 |
Min: 27.0.0 Max: - |
Perl
API de Google Ads |
Biblioteca cliente para Perl |
v18 |
Min: 25.0.0 Max: - |
v17 |
Min: 23.0.0 Max: - |
v16 |
Min: 21.0.0 Max: - |
Bajas de funciones
Supervisa periódicamente el blog para desarrolladores de Google Ads para ser la primera persona en enterarse de las próximas funciones que se darán de baja.
En la siguiente tabla, se enumeran las baja de funciones específicas que se planean actualmente 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 |
---|---|---|---|
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 . |
Enero de 2025 | Cuando se desactive la versión v16, todas las solicitudes
GoogleAdsService.Search
asumirán un tamaño de página fijo de 10,000 filas. |
Estrategia de ofertas de CPC avanzado | La API de Google Ads ya no admite la configuración del CPCA como una estrategia de ofertas para las campañas de Búsqueda y Display. | Octubre de 2024 |
Las solicitudes para establecer el campo enhanced_cpc_enabled en TRUE en una estrategia de ofertas generarán un error BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED . Las campañas existentes con la estrategia de ofertas de CPCA se seguirán publicando hasta el 15 de marzo de 2025. Después de esta fecha, se migrarán automáticamente al costo por clic (CPC) manual.
|