Control de versiones

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Control de versiones semántico

La API de Google Ads sigue el control de versiones semántico en el que hay una versión principal y una secundaria. El formato de la versión es MAJOR.MINOR o vMAJOR_MINOR. Por ejemplo, v12_0 es una versión principal, mientras que v12_1 es una versión secundaria.

Consulte las notas de la versión para conocer las versiones anteriores.

Versiones principales

Las versiones de actualización importantes introducen algunos cambios incompatibles con versiones anteriores. La versión terminaría en cero con el formato vX_0, en el que X es el número de versión principal.

Cada versión principal tiene un extremo independiente. Este es un ejemplo de la URL en la que X es el número de versión principal.

https://googleads.googleapis.com/vX

Si actualizas desde una versión principal anterior, es posible que tu código requiera cambios cuando cambies al extremo de la versión principal nueva. Si usas nuestras bibliotecas cliente, actualiza a la versión más reciente. Cuando se lance una versión principal, te proporcionaremos una guía de migración que deberás revisar para corregir cualquier cambio rotundo en tu código.

Estos son algunos ejemplos de cambios rotundos:

  • Quitar o renombrar un servicio, interfaz, campo, método o valor de enumeración
  • Cambiar el tipo de un campo
  • Cambia un formato de nombre de recurso.
  • Cambia el formato de URL en la definición HTTP.
  • Cambiar los formatos de salida, como cambiar de 0 a -- como valor predeterminado
  • Cambia el motivo del error que se muestra de A a B.

Versiones secundarias

Las versiones secundarias solo introducen cambios compatibles con versiones anteriores. Para una versión secundaria, vMAJOR_MINOR tendría un número MINOR mayor que cero.

Cuando se lanza una versión secundaria, el extremo que ya está en uso se actualiza de forma automática. Esto no causará fallas en tu código. Puedes seguir usando tus bibliotecas cliente existentes.

Las versiones secundarias incluyen actualizaciones o funciones nuevas que no afectan tu código existente. Si deseas usar estas funciones nuevas, actualiza tus bibliotecas cliente a la versión más reciente.

Puestas de sol

Las versiones anteriores de la API de Google Ads deberán darse de baja de manera periódica. Publicaremos avisos en el blog para desarrolladores cuando se publique una versión. El programa de baja se actualiza con fechas de vencimiento futuras.