Con el lanzamiento de una nueva versión, a una versión obsoleta se le asigna una fecha de desactivación, después de la cual esa versión dejará de estar disponible. A continuación, se incluyen otros lineamientos que debes tener en cuenta:
- Como máximo, hay tres versiones principales disponibles al mismo tiempo.
- Las versiones principales tienen una vida útil de alrededor de 12 meses, y versiones secundarias: 10 meses.
- Deberás realizar como máximo dos actualizaciones por año, y no deberás hacerlo 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 de la versión más reciente y la fecha de desactivación de la versión es de al menos 20 semanas.
Nuestras bibliotecas cliente admiten cualquier versión disponible de un servicio, por lo que puedes actualizarla de forma gradual especificando diferentes versiones de los servicios usados.
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 previstas para las versiones futuras. Te recomendamos que actualices a la versión más reciente lo antes posible después del lanzamiento.
Versión de API | Fecha de lanzamiento | Fecha de baja | Fecha de descontinuación | Guía de actualización |
---|---|---|---|---|
v18 | Sep/oct de 2024 | Ene/febrero de 2025 | Septiembre de 2025 | |
v17.1 | Jul/ago de 2024 | Sep/oct de 2024 | Mayo de 2025 | |
v17 | Mayo/jun de 2024 | Sep/oct de 2024 | Mayo de 2025 | |
v16.1 | Abr/mayo de 2024 | Mayo/jun de 2024 | Enero de 2025 | |
v16 | 21 de febrero de 2024 | Mayo/jun de 2024 | Enero de 2025 | |
v15 | 18 de octubre de 2023 | 21 de febrero de 2024 | 25 de septiembre de 2024 | Actualiza de la versión 15 a la 16 |
v14.1 | 9 de agosto de 2023 | 18 de octubre de 2023 | 5 de junio de 2024 | |
v14 | 7 de junio de 2023 | 18 de octubre de 2023 | 5 de junio de 2024 | Actualiza de la versión 14 a la 15 |
Consulta las versiones que utiliza tu proyecto
Puedes ver una lista de métodos y servicios a los que tu proyecto llamó recientemente con Google Cloud Console:
- Abre APIs y servicios 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 reflejadas 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.v16.services.GoogleAdsService.Mutate
. - (Opcional) Selecciona el período que quieres ver para tus solicitudes.
Diferencias entre la baja y la desactivación
Período | Baja | Atardecer |
---|---|---|
Definición | La versión obsoleta es una versión que no es la más reciente. Cuando se lance una nueva versión, todas las versiones anteriores se marcarán como obsoletas. | La versión con retiro en curso ya no se puede usar. 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 desactive, pero se quitan las referencias de las versiones obsoletas para mostrar que ya no son la más reciente.
Te recomendamos que actualices a la versión más reciente lo antes posible para aprovechar las funciones nuevas. |
Debes realizar la actualización desde 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 dejará de estar disponible después de aproximadamente 3 o 4 meses. | Nuestro objetivo es retirar una versión 1 año después de su lanzamiento. |
API | Los extremos de la API para las versiones obsoletas seguirán funcionando como de costumbre.
Puedes acceder a los extremos de nuestra API mediante nuestras bibliotecas cliente, REST, etc. Sin embargo, las funciones nuevas no se agregan a las versiones obsoletas. |
Los extremos de API para las versiones descontinuadas 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 descontinuadas. |
Bibliotecas cliente | Para proporcionar bibliotecas cliente compactas, dejaremos de incluir versiones obsoletas de API en una versión nueva de la biblioteca cliente después de la fecha de baja. Esto te permite ahorrar espacio cuando incorporas nuestras bibliotecas cliente en tus proyectos. | Las bibliotecas cliente ya no admiten las versiones de la API descontinuadas en ninguna versión nueva de ellas después de las fechas de desactivación. |
Asistencia | Ofrecemos asistencia frecuente para las versiones obsoletas. | Estas versiones ya no son compatibles después de la fecha de desactivación. |
Versiones de bibliotecas cliente compatibles
En la tabla, se muestra qué bibliotecas cliente funcionan con las distintas versiones de la API.
Java
API de Google Ads |
Biblioteca cliente para Java |
v16 |
Min: 30.0.0 Max: - |
v15 |
Min: 28.0.0 Max: - |
v14 |
Min: 26.0.0 Max: - |
C#
API de Google Ads |
Biblioteca cliente para .NET |
v16 |
Min: 18.1.0 Max: - |
v15 |
Min: 17.1.0 Max: - |
v14 |
Min: 16.1.0 Max: - |
PHP
API de Google Ads |
Biblioteca cliente para PHP |
v16 |
Min: 22.1.0 Max: - |
v15 |
Min: 21.1.0 Max: - |
v14 |
Min: 19.2.0 Max: - |
Python
API de Google Ads |
Biblioteca cliente para Python |
v15 |
Min: 22.1.0 Max: - |
v14 |
Min: 21.2.0 Max: - |
Rita
API de Google Ads |
Biblioteca cliente para Ruby |
v16 |
Min: 27.0.0 Max: - |
v15 |
Min: 25.0.0 Max: - |
v14 |
Min: 23.0.0 Max: - |
Perl
API de Google Ads |
Biblioteca cliente para Perl |
v16 |
Min: 21.0.0 Max: - |
v15 |
Min: 19.0.0 Max: - |
v14 |
Min: 17.0.0 Max: - |
Bajas de funciones
Supervisa el blog para desarrolladores de Google Ads con frecuencia para ser una de las primeras personas en enterarte de las próximas funciones que dejarán de estar disponibles.
En la siguiente tabla, se indican las funciones específicas que actualmente se darán de baja 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 |
---|---|---|---|
Estrategia de oferta de Comisiones |
La API de Google Ads
ya no admite la creación de campañas de hoteles con la estrategia de ofertas COMMISSION
.
|
30 de abril de 2024 |
Las solicitudes para crear campañas de hoteles nuevas o aplicar la estrategia de ofertas COMMISSION
a campañas existentes generarán un error
BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED . Las campañas existentes con la estrategia de ofertas COMMISSION
seguirán publicándose hasta el 31 de octubre de 2024. Después de este día,
las campañas dejarán de publicar anuncios hasta que se actualice su estrategia de ofertas.
|