Baja y eliminación

Con el lanzamiento de una nueva versión, una solicitud versión recibe una fecha de desactivación, después de la cual esa versión ya no se disponibles. A continuación, se incluyen otras pautas que debes tener en cuenta:

  • Como máximo, hay tres versiones principales disponibles a la vez.
  • Las versiones principales tienen una vida útil de aproximadamente 12 meses y las versiones secundarias son las siguientes: 10 meses.
  • Tendrás que realizar como máximo dos actualizaciones por año y no para actualizar en orden secuencial, por ejemplo, puede actualizar de la versión (N) directamente a la versión (N+2).
  • La superposición entre la fecha en que se lanzaron todas las bibliotecas cliente del a la última versión y que la que se retire es de, al menos, 20 semanas.

Nuestras bibliotecas cliente admiten cualquier versión disponible de un por lo que puedes realizar actualizaciones de forma gradual especificando diferentes versiones de Google Cloud.

Horario

En la siguiente tabla, se indican las fechas específicas de baja y desactivación de cada la versión disponible y las fechas de lanzamiento previstas para versiones futuras. Mié 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 Sep/oct de 2024 ene/feb de 2025 Septiembre de 2025
v17.1 7 de agosto de 2024 Sep/oct de 2024 Mayo de 2025
v17 5 de junio de 2024 Sep/oct de 2024 Mayo de 2025
v16.1 24 de abril de 2024 Mayo/junio de 2024 Enero de 2025
v16 21 de febrero de 2024 Mayo/junio de 2024 Enero de 2025 Actualización de la versión 16 a la 17
v15 18 de octubre de 2023 21 de febrero de 2024 25 de septiembre de 2024 Actualización de la versión 15 a la 16

Visualiza las versiones que usa tu proyecto

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

  1. Abre el menú de APIs y Servicios en la consola de Google Cloud.
  2. Haz clic en API de Google Ads en la tabla.
  3. En la pestaña secundaria METRICS, deberías ver tus solicitudes recientes reflejadas en cada gráfico. Puedes ver a qué métodos enviaste solicitudes en la Methods. 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.v17.services.GoogleAdsService.Mutate
  4. (Opcional) Elige el período que quieres ver para tus solicitudes.

Diferencias entre la baja y la descontinuación

TérminoBajaAtardecer
Definición La versión obsoleta es una que no es la más reciente. Cuando se lanza una nueva versión, se marcarán todas las versiones anteriores obsoleto. Ya no se puede usar la versión descontinuada. Se enviaron solicitudes a esta la versión fallará a partir de la fecha de desactivación.
Implicación Puedes seguir usando las versiones obsoletas hasta que se reactiven. pero las referencias de las versiones obsoletas se quitan para mostrar que ya no tienen la versión más reciente.

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

Debes actualizar desde las versiones descontinuadas de inmediato en para utilizar la API de Google Ads.

Te recomendamos que actualices a la versión más reciente versión, con la guía de actualización.

Duración En promedio, lanzamos una versión nueva cada 3 o 4 meses, así que, dejará de estar disponible después de unos 3 a 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 habitual.

Puedes acceder a los extremos de nuestra API con nuestras bibliotecas cliente, REST, y activado; 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 fechas de atardeceres. La API de Google Ads arrojará un error si intentas acceder a la Extremos de la API de las versiones descontinuadas.
Bibliotecas cliente Para proporcionar bibliotecas cliente compactas, dejaremos de incluidas versiones obsoletas de la API 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 la API descontinuadas en cualquier versión nueva de la biblioteca cliente después de las fechas de desactivación.
Asistencia Ofrecemos asistencia periódica para las versiones obsoletas. Las versiones descontinuadas ya no serán compatibles después del retiro fecha.

Versiones compatibles de bibliotecas cliente

La tabla muestra qué bibliotecas cliente funcionan con qué versiones de API.

Java

Biblioteca cliente para Java
v17 Min: 32.0.0
Max::
v16 Min: 30.0.0
Max::
v15 Min: 28.0.0
Max: 32.0.0

C#

Biblioteca cliente para .NET
v17 Min: 20.1.0
Max::
v16 Min: 18.1.0
Max::
v15 Min: 17.1.0
Max: 20.1.0

PHP

Biblioteca cliente para PHP
v17 Min: 23.1.0
Max::
v16 Min: 22.1.0
Max::
v15 Min: 21.1.0
Max: 23.1.0

Python

Biblioteca cliente para Python
v17 Min: 24.1.0
Max::
v16 Min: 23.1.0
Max::
v15 Min: 22.1.0
Max::

Rita

Biblioteca cliente para Ruby
v17 Min: 29.0.0
Max::
v16 Min: 27.0.0
Max::
v15 Min: 25.0.0
Max::

Perl

Biblioteca cliente para Perl
v17 Min: 23.0.0
Max::
v16 Min: 21.0.0
Max::
v15 Min: 19.0.0
Max::

Bajas de funciones

Supervisar periódicamente el blog para desarrolladores de Google Ads para ser la primera persona en enterarse de las próximas funciones que dejarán de estar disponibles.

En la siguiente tabla, se indican las funciones específicas que se pueden dar de baja actualmente previsto 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 COMMISSION estrategia de ofertas 30 de abril de 2024 Solicitudes para crear campañas de hoteles nuevas o aplicar las COMMISSION estrategia de ofertas a las campañas existentes generará una BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED . Campañas existentes con la oferta de COMMISSION esta estrategia seguirá funcionando hasta el 31 de octubre de 2024. Después de este día tus campañas dejarán de publicarse hasta que se actualice su estrategia de ofertas.