Se lanzan nuevas versiones de la API de Campaign Manager 360 con regularidad. A medida que se lanzan versiones nuevas, las versiones anteriores se marcan como obsoletas y, finalmente, se desactivan. Cuando se retira una versión, todas las solicitudes a esa versión comienzan a devolver errores.
Si la versión que usas está obsoleta, 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 del 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 .
- Ubica 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 avanzados de Google.
- Ubica 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.v3_4
- Se expone a través de 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>v3.4-rev1-1.21.0</version> </dependency>
- Se incluye en el nombre del archivo JAR.
google-api-services-dfareporting-v3.4-rev1-1.21.0.jar
- Se expone a través de 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 a través de una propiedad pública de Google_Service_Dfareporting:
$service = new Google_Service_Dfareporting($client) print $service->version;
Python
La biblioteca cliente de las APIs 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', 'v3.4', http=http)
Ruby
Las versiones de la biblioteca cliente de la API de Google para Ruby anteriores a la 0.9 no tienen versiones. La versión de la API que se usará se especifica como un argumento para el constructor del servicio:
service = Google::APIClient::Service.new("dfareporting", "v3.4", { :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.DfareportingV3_4
Paso 2: Determina el estado de tu versión
Consulta el programa de baja para determinar el estado de tu versión. Si tu versión no aparece en la lista, significa que se retiró y ya no es compatible.
Si tu versión aparece en la lista, consulta las columnas Fecha de baja y Fecha de cierre:
- Si no hay fechas, tu versión es totalmente compatible.
- Si hay fechas, tu versión es obsoleta y dejará de estar disponible en la fecha especificada.
Si tu versión está obsoleta o se descontinuó, 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 programa (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 u 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 separadas 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 deseas usar para 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, haz clic en Agregar un servicio .
- Ubica 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 versiones.
- 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 deseas usar para 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 avanzados de Google.
- Ubica 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 versiones.
- Haz clic en Aceptar para guardar los cambios.
C#
La biblioteca cliente de la API de Google para .NET proporciona compilaciones separadas 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 deseas usar.
Para obtener instrucciones de instalación detalladas o ver otras opciones de descarga, consulta la documentación de la biblioteca cliente.
Java
La biblioteca cliente de la API de Google para Java proporciona compilaciones separadas 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 deseas usar.
Para obtener instrucciones de instalación detalladas o ver otras opciones de descarga, 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 deseas usar.
Para obtener instrucciones de instalación detalladas o ver otras opciones de descarga, consulta la documentación de la biblioteca cliente.
Python
Cada compilación de la biblioteca cliente de las APIs de Google para Python (v1/v2) admite todas las versiones de la API de Campaign Manager 360. Para migrar a una nueva versión 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', 'v3.4', 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 nueva versión de la API de Campaign Manager 360, actualiza la cadena de versión que se pasa como argumento al constructor del servicio:
service = Google::APIClient::Service.new("dfareporting", "v3.4", { :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 migres de v4 a v5, cambiarás la URL base de la siguiente manera:
https://dfareporting.googleapis.com/dfareporting/v4/...
https://dfareporting.googleapis.com/dfareporting/v5/...
Paso 4: Aborda las diferencias entre versiones de direcciones
Las versiones nuevas de la API se diseñan para que sean retrocompatibles siempre que sea posible. Sin embargo, algunas actualizaciones pueden incluir cambios rotundos que requieren que modifiques tu código. Estos cambios se detallan en las notas de la versión.
Cuando migres, revisa las notas de la versión de cada versión entre la versión actual y la versión a la que actualizarás. Presta especial atención a las siguientes secciones:
- Nuevas funciones: Funcionalidad agregada recientemente. No requieren cambios de código para la migración.
- Bajas: Se quitó la funcionalidad de la API. Cuando está disponible, se indica la funcionalidad de reemplazo.
- Problemas conocidos: Son modificaciones en la funcionalidad existente, como el cambio de nombre de campos o métodos, o la modificación de la lógica de validación.
Si tu aplicación usa la funcionalidad que se indica en las secciones Desactivaciones 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 vencimientos de las APIs.