Migra a una versión nueva

Se lanzan versiones nuevas de la API de Campaign Manager 360 con regularidad. A medida que se lanzan versiones nuevas, las versiones anteriores dejaron de estar disponibles y, con el tiempo, pierden tiempo. Cuando se establece una versión, todas las solicitudes en ella comienzan a mostrar errores.

Si una versión de la API que usas está obsoleta, deberás migrar a una versión más reciente antes de la fecha de vencimiento programada. En esta guía, se proporcionan detalles para determinar si la versión de la API que estás usando está obsoleta y se proporcionan los pasos de migración recomendados.

Paso 1: Determina qué versión estás usando

Si sospechas que una aplicación que usas puede estar usando una versión obsoleta de la API de Campaign Manager 360, primero debes verificar qué versión específica estás usando. En la mayoría de los casos, accederás a la API mediante una de nuestras bibliotecas cliente específicas del lenguaje o mediante una integración oficial. A continuación, puedes encontrar instrucciones para encontrar la versión de la API en uso de estas integraciones y bibliotecas cliente:

Nuevo editor de Apps Script

La información de la versión de Apps Script se expone en el diálogo de servicios avanzados:

1. En el editor de Apps Script, haz clic en Agregar un servicio .
2. Busque la API de Campaign Manager 360 en la lista de servicios disponibles.
3. El valor seleccionado en el menú desplegable de versiones es la versión actual de la API de Campaign Manager 360.

Editor heredado de Apps Script

La información de la versión de Apps Script se expone en el diálogo de servicios avanzados:

1. En el editor de Apps Script, navegue a Recursos > Servicios avanzados de Google.
2. Busque la API de Campaign Manager 360 en la lista de servicios disponibles.
3. El valor seleccionado en el menú desplegable de versiones es la versión actual de la API de Campaign Manager 360.

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:

1. Se incluye en el nombre del paquete nuget y el espacio de nombres del servicio.

   Google.Apis.Dfareporting.v3_4

2. 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:

1. Especificada en el artefacto maven artifactId.

   <dependency>
     <groupId>com.google.apis</groupId>
     <artifactId>google-api-services-dfareporting</artifactId>
     <version>v3.4-rev1-1.21.0</version>
   </dependency>

2. Se incluye en el nombre de archivo JAR.

   google-api-services-dfareporting-v3.4-rev1-1.21.0.jar

3. 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 la API de Google para Python no tiene un control de versiones. La versión de la API que se usa se especifica como un argumento para el compilador de descubrimiento:

discovery.build('dfareporting', 'v3.4', http=http)

Ruby

Las bibliotecas cliente de la API de Google para las versiones de Ruby inferiores a 0.9 no tienen versiones. La versión de la API que se usa 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 la versión de la biblioteca cliente de la API de Google para Ruby >= 0.9, la versión se expone en el espacio de nombres de servicio:

Google.Apis.DfareportingV3_4

Toma nota de la versión que usas, ya que necesitarás esta información más adelante.

Paso 2: Determine el estado de su versión

En el programa de baja, se muestra el estado de todas las versiones admitidas. Encuentra tu versión en esta lista y determina su estado de la siguiente manera:

1. Si no aparecen fechas en las columnas Fecha de baja y Fecha de puesta, significa que estás usando una versión totalmente compatible.
2. Si se incluyen las fechas, la versión que estás usando está obsoleta y se dará de baja en la fecha especificada.
3. Si tu versión no aparece en la lista, quiere decir que ya no está disponible y que ya no es compatible.

Si se encuentra en el segundo o el tercer paso, deberá migrar a una versión más reciente para evitar una interrupción del servicio. Se recomienda que migres a la versión más reciente, que se encuentra en la parte superior de la tabla del programa de baja (se excluyen las versiones beta). Esto le dará el tiempo máximo entre actualizaciones.

Paso 3: Actualiza las versiones

Si determinaste que necesitas migrar, el siguiente paso es 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 solo una compilación que funcione con cualquier versión de API, otras tendrán compilaciones independientes para cada versión. La siguiente lista proporciona información general sobre las actualizaciones para las integraciones y bibliotecas cliente más utilizadas.

Nuevo editor de Apps Script

Google Apps Script es compatible con todas las versiones de la API de Campaign Manager 360 y le permite seleccionar la versión por secuencia de comandos. Para cambiar la versión utilizada por una secuencia de comandos en particular:

1. En el editor de Apps Script, haz clic en Agregar un servicio .
2. Busque la API de Campaign Manager 360 en la lista de servicios disponibles.
3. Cambie la versión de la API de Campaign Manager 360 en uso mediante el menú desplegable de versiones.
4. Haz clic en Agregar para guardar los cambios.

Editor heredado de Apps Script

Google Apps Script es compatible con todas las versiones de la API de Campaign Manager 360 y le permite seleccionar la versión por secuencia de comandos. Para cambiar la versión utilizada por una secuencia de comandos en particular:

1. En el editor de Apps Script, navegue a Recursos > Servicios avanzados de Google.
2. Busque la API de Campaign Manager 360 en la lista de servicios disponibles.
3. Cambie la versión de la API de Campaign Manager 360 en uso mediante el menú desplegable de versiones.
4. 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, distribuidas a través de Nuget.

Para obtener instrucciones de instalación detalladas o alternativas de descarga alternativas, consulta la documentación sobre bibliotecas 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, distribuidas a través de Maven.

Para obtener instrucciones de instalación detalladas o alternativas de descarga alternativas, consulta la documentación sobre bibliotecas 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, distribuidas mediante Packagist.

Para obtener instrucciones de instalación detalladas o alternativas de descarga alternativas, consulta la documentación sobre bibliotecas cliente.

Python

Cada compilación de la biblioteca cliente de la API de Google para Python es compatible con todas las versiones de la API de Campaign Manager 360. Simplemente actualiza la string de la versión que se pasa como argumento al compilador de detección:

discovery.build('dfareporting', 'v3.4', http=http)

Para obtener instrucciones de instalación detalladas o alternativas de descarga alternativas, consulta la documentación sobre bibliotecas cliente.

Ruby

La biblioteca cliente de la API de Google para Ruby v0.8 y versiones anteriores es compatible con todas las versiones de la API de Campaign Manager 360. Simplemente actualiza la string de la 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
    }
)

La biblioteca cliente de la API de Google para Ruby v0.9+ proporciona compilaciones independientes para cada versión de la API de Campaign Manager 360, distribuidas a través de RubyGems. Para obtener instrucciones de instalación detalladas o alternativas de descarga alternativas, consulta la documentación sobre bibliotecas cliente.

Paso 4: Aborda las diferencias de versiones

Nos esforzamos para que nuestras nuevas versiones sean retrocompatibles, lo que significa que la migración entre versiones de API no requerirá cambios en tu código. Cuando esto no es posible, anunciamos los cambios que requieren acción de los desarrolladores (también conocidos como cambios rotundos) en nuestras notas de la versión.

En este punto, debe revisar nuestras notas de la versión. Comience con la versión que sigue a la que comenzó (que tomó nota en una sección anterior) y continúe hasta la versión que va a actualizar. Las secciones de las notas de la versión deben interpretarse de la siguiente manera:

• Nuevas funciones: Funciones agregadas recientemente.
• Atardeceres: Funcionalidad que se quitó de la API. Cuando esté disponible, se explicará la funcionalidad del reemplazo en esta sección.
• Problemas conocidos: Cambios que no son adiciones ni eliminaciones. Por ejemplo, esta sección puede abarcar los campos o métodos que han cambiado de nombre, o la lógica de validación que ha cambiado.

La funcionalidad en Nuevas funciones no requerirá cambios de código y, por el momento, puede ignorarse. No dude en volver a esta sección más adelante si desea experimentar con algo que hayamos agregado.

Por el contrario, si ves cambios en las secciones Atardeceres o Problemas conocidos, es posible que debas tomar medidas. Debes buscar en el código para determinar si tu aplicación usa alguna de las funcionalidades eliminadas o modificadas. De ser así, deberá actualizar su código para abordar estos cambios.

Mantente informado

Como se mencionó anteriormente, las actualizaciones y los atardeceres de la API de Campaign Manager 360 se realizan con frecuencia. Se publican actualizaciones sobre lanzamientos nuevos, bajas y puestas de sol en los siguientes canales:

• Blog para desarrolladores de Google Ads (suscríbase para recibir alertas por correo electrónico)
• Foro de la API de Campaign Manager 360

Te recomendamos que te suscribas a uno o más de estos canales para mantenerte al tanto de las últimas novedades de las API.