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 versión secundaria. El formato de la versión es MAJOR.MINOR o vMAJOR_MINOR. Por ejemplo, v24_0 es una versión principal, mientras que v24_1 es una versión secundaria.
Consulta las notas de la versión para conocer las versiones anteriores.
Versiones principales
Las versiones principales de lanzamiento introducen algunos cambios rotundos e 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 la versión principal.
Cada versión principal tiene un extremo independiente. En esta URL de ejemplo, X es el número de la versión principal.
https://googleads.googleapis.com/vX
Si realizas una actualización desde una versión principal anterior, es posible que tu código requiera cambios cuando cambies al nuevo extremo de la versión principal. Si usas nuestras bibliotecas cliente, actualiza a la versión más reciente. Cuando se lance una versión principal, proporcionaremos una guía de migración que debes consultar para corregir cualquier cambio rotundo en tu código.
Estos son algunos ejemplos de cambios rotundos:
- Quitar o volver a nombrar un servicio, interfaz, campo, método o valor de enum
- Cambiar el tipo de un campo
- Cambia un formato de nombre de recurso
- Cambiar el formato de URL en la definición HTTP
- Cambiar los formatos de salida, como cambiar de
0a--como valor predeterminado - Cambiar 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 MINOR número mayor que cero.
Cuando se lance una versión secundaria, el extremo que ya está en uso se actualizará automáticamente. Esto no hará que tu código se interrumpa. Puedes seguir usando las bibliotecas cliente existentes.
Las versiones secundarias incluyen funciones o actualizaciones 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
Periódicamente, las versiones anteriores de la API de Google Ads deberán desactivarse. Publicaremos avisos en el blog para desarrolladores cuando una versión esté a punto de desactivarse. El cronograma de baja se actualiza con las fechas de desactivación futuras.