Se publican versiones nuevas de la API de Campaign Manager 360 con regularidad. A medida que se lanzan versiones nuevas, las anteriores dejan de estar disponibles y, finalmente, se retiran. Cuando se retira una versión, todas las solicitudes que se realizan en ella comienzan a mostrar errores.
Si la versión que usas dejó de estar disponible, debes actualizarla lo antes posible para evitar interrupciones del servicio.
Paso 1: Determina qué versión usas
Puedes determinar qué versión de la API usas con las siguientes instrucciones. En la mayoría de los casos, accederás a la API con una de nuestras bibliotecas cliente específicas de un lenguaje o una integración oficial.
Nuevo editor de Apps Script
La información de la versión de Apps Script se expone en el diálogo de servicios avanzados:
- En el editor de Apps Script, haz clic en Agregar un servicio .
- Busca la API de Campaign Manager 360 en la lista de servicios disponibles.
- El valor seleccionado en el menú desplegable de la versión es la versión de la API de Campaign Manager 360 en uso.
Editor heredado de Apps Script
La información de la versión de Apps Script se expone en el diálogo de servicios avanzados:
- En el editor de Apps Script, navega a Recursos > Servicios de Google avanzados.
- Busca la API de Campaign Manager 360 en la lista de servicios disponibles.
- El valor seleccionado en el menú desplegable de la versión es la versión de la API de Campaign Manager 360 en uso.
C#
La información de la versión de la biblioteca cliente de la API de Google para .NET se expone en los siguientes lugares:
- Se incluye en el nombre del paquete NuGet y el espacio de nombres del servicio.
Google.Apis.Dfareporting.v5
- Se expone con una propiedad pública de
DfareportingService.Console.WriteLine(DfareportingService.Version);
Java
La información de la versión de la biblioteca cliente de la API de Google para Java se expone en los siguientes lugares:
- Se especifica en el artifactId de Maven.
<dependency> <groupId>com.google.apis</groupId> <artifactId>google-api-services-dfareporting</artifactId> <version>v5-rev20260213-2.0.0</version> </dependency>
- Se incluye en el nombre de archivo JAR.
google-api-services-dfareporting-v5-rev20260213-2.0.0.jar
- Se expone con una propiedad pública de
Dfareporting.System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);
PHP
La información de la versión de la biblioteca cliente de la API de Google para PHP se expone con una propiedad pública de Google_Service_Dfareporting:
$service = new Google_Service_Dfareporting($client) print $service->version;
Python
La biblioteca cliente de la API de Google para Python (v1/v2) no tiene versiones. La versión de la API que se usará se especifica como un argumento para el compilador de descubrimiento:
discovery.build('dfareporting', 'v5', http=http)
Ruby
Las versiones de la biblioteca cliente de la API de Google para Ruby < 0.9 no tienen versiones. La versión de la API que se usará se especifica como un argumento para el constructor de servicios:
service = Google::APIClient::Service.new("dfareporting", "v5", { :application_name => "My application", :application_version => '1.0.0', :authorization => authorization } )
Para las versiones de la biblioteca cliente de la API de Google para Ruby >= 0.9, la versión se expone en el espacio de nombres del servicio:
Google.Apis.DfareportingV5
Paso 2: Determina el estado de tu versión
Consulta el cronograma de baja para determinar el estado de tu versión. Si tu versión no aparece en la lista, se retiró y ya no es compatible.
Si tu versión aparece en la lista, consulta las columnas Fecha de baja y Fecha de retiro:
- Si no hay fechas, tu versión es totalmente compatible.
- Si hay fechas, tu versión dejó de estar disponible y se retirará en la fecha especificada.
Si tu versión dejó de estar disponible o se retiró, debes migrar a una versión más reciente para evitar interrupciones del servicio. Te recomendamos que migres a la versión más reciente que se muestra en el cronograma (sin incluir las versiones beta) para maximizar el tiempo entre las actualizaciones.
Paso 3: Actualiza las versiones
Para migrar a una versión más reciente de la API, deberás actualizar tu integración o obtener una compilación actualizada de tu biblioteca cliente preferida. Ten en cuenta que, si bien algunas bibliotecas cliente pueden proporcionar una sola compilación que funcione con cualquier versión de la API, otras tendrán compilaciones independientes para cada versión. En la siguiente lista, se proporciona información general sobre la actualización de las bibliotecas cliente y las integraciones más utilizadas.
Nuevo editor de Apps Script
Google Apps Script admite todas las versiones de la API de Campaign Manager 360 y te permite seleccionar la versión que se usará en cada secuencia de comandos. Para cambiar la versión que usa una secuencia de comandos en particular, haz lo siguiente:
- En el editor de secuencias de comandos, haz clic en Agregar un servicio .
- Busca la API de Campaign Manager 360 en la lista de servicios disponibles.
- Cambia la versión de la API de Campaign Manager 360 con el menú desplegable de la versión.
- Haz clic en Agregar para guardar los cambios.
Editor heredado de Apps Script
Google Apps Script admite todas las versiones de la API de Campaign Manager 360 y te permite seleccionar la versión que se usará en cada secuencia de comandos. Para cambiar la versión que usa una secuencia de comandos en particular, haz lo siguiente:
- En el editor de Apps Script, navega a Recursos > Servicios de Google avanzados.
- Busca la API de Campaign Manager 360 en la lista de servicios disponibles.
- Cambia la versión de la API de Campaign Manager 360 con el menú desplegable de la versión.
- Haz clic en Aceptar para guardar los cambios.
C#
La biblioteca cliente de la API de Google para .NET proporciona compilaciones independientes para cada versión de la API de Campaign Manager 360, que se distribuyen a través de NuGet. Actualiza a una versión de la biblioteca cliente que corresponda a la versión de la API que quieres usar.
Para obtener instrucciones de instalación detalladas o opciones de descarga alternativas, consulta la documentación de la biblioteca cliente.
Java
La biblioteca cliente de la API de Google para Java proporciona compilaciones independientes para cada versión de la API de Campaign Manager 360, que se distribuyen a través de Maven. Actualiza a una versión de la biblioteca cliente que corresponda a la versión de la API que quieres usar.
Para obtener instrucciones de instalación detalladas o opciones de descarga alternativas, consulta la documentación de la biblioteca cliente.
PHP
La biblioteca cliente de la API de Google para PHP proporciona compilaciones independientes para cada versión de la API de Campaign Manager 360, que se distribuyen a través de Packagist. Actualiza a una versión de la biblioteca cliente que corresponda a la versión de la API que quieres usar.
Para obtener instrucciones de instalación detalladas o opciones de descarga alternativas, consulta la documentación de la biblioteca cliente.
Python
Cada compilación de la biblioteca cliente de la API de Google para Python (v1/v2) admite todas las versiones de la API de Campaign Manager 360. Para migrar a una versión nueva de la API de Campaign Manager 360, actualiza la cadena de versión que se pasa como argumento al compilador de descubrimiento:
discovery.build('dfareporting', 'v5', http=http)
Ruby
La biblioteca cliente de la API de Google para Ruby v0.8 y versiones anteriores admite todas las versiones de la API de Campaign Manager 360. Para migrar a una versión nueva de la API de Campaign Manager 360, actualiza la cadena de versión que se pasa como argumento al constructor de servicios:
service = Google::APIClient::Service.new("dfareporting", "v5", { :application_name => "My application", :application_version => '1.0.0', :authorization => authorization } )
REST
Si llamas a la API directamente con HTTPS, actualiza el extremo de tus solicitudes para usar el nuevo número de versión de la API.
Por ejemplo, cuando migras de v4 a v5, cambiarías la URL base de la siguiente manera:
https://dfareporting.googleapis.com/dfareporting/v4/...
https://dfareporting.googleapis.com/dfareporting/v5/...
Paso 4: Aborda las diferencias de versión
Las versiones nuevas de la API están diseñadas para ser retrocompatibles siempre que sea posible. Sin embargo, algunas actualizaciones pueden incluir cambios rotundos que requieran que modifiques tu código. Estos cambios se detallan en las notas de la versión.
Cuando realices la migración, revisa las notas de la versión de cada versión entre la versión actual y la versión a la que estás actualizando. Presta especial atención a las siguientes secciones:
- Nuevas funciones: Funcionalidad recién agregada. No requieren cambios de código para la migración.
- Retiros: Funcionalidad quitada de la API. La funcionalidad de reemplazo se indica cuando está disponible.
- Problemas conocidos: Modificaciones a la funcionalidad existente, como campos o métodos renombrados, o lógica de validación modificada.
Si tu aplicación usa la funcionalidad que aparece en las secciones Retiros o Problemas conocidos, deberás actualizar tu código para abordar estos cambios.
Mantente informado
Supervisa periódicamente el blog para desarrolladores de Google Ads para ser el primero en enterarte de los lanzamientos, las bajas y los retiros de la API.