Control de versiones semántico
La API de Google Ads sigue el control de versiones semánticas, 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, v18_0 es una versión principal, mientras que v18_1 es una versión secundaria.
Consulta las notas de la versión para ver las versiones anteriores.
Versiones principales
Las versiones principales introducen algunos cambios incompatibles con versiones anteriores.
La versión finalizarí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 nueva versión principal. 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 seguir para corregir los cambios drásticos en tu código.
Estos son algunos ejemplos de cambios rotundos:
- Quitar o cambiar el nombre de un servicio, una interfaz, un campo, un método o un valor de enumeración
- Cambiar el tipo de un campo
- Cambiar 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 retrocompatibles. Para una versión menor, vMAJOR_MINOR tendría un número MINOR 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 se rompa el código. Puedes seguir usando tus bibliotecas cliente existentes.
Las versiones menores incluyen funciones nuevas o actualizaciones que no afectan tu código existente. Si quieres usar estas funciones nuevas, actualiza tus bibliotecas cliente a la versión más reciente.
Puestas de sol
De forma periódica, se desactivarán las versiones anteriores de la API de Google Ads. Publicaremos avisos en el blog para desarrolladores cuando una versión esté a punto de dejar de estar disponible. El programa de baja se actualiza con las fechas de desactivación futuras.