Control de versiones

Control de versiones semántico

La API de Google Ads sigue el control de versiones semántico, en el que se aplica lo siguiente: una versión mayor y una secundaria. El formato de la versión es MAJOR.MINOR o vMAJOR_MINOR Por ejemplo, v17_0 es una versión principal, mientras que v17_1 es una versión secundaria.

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

Versiones principales

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

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

https://googleads.googleapis.com/vX

Si estás actualizando desde una versión principal anterior, es posible que el código requiera cambia cuando cambias al nuevo extremo de la versión principal. Si utilizas nuestra bibliotecas cliente y, luego, actualiza a la versión más reciente. Cuando se lance una versión principal, proporcionaremos una guía de migración que deberías realizar para corregir cualquier cambio rotundo en tu código.

Estos son algunos ejemplos de cambios rotundos:

• Quitar o cambiar el nombre de un servicio, interfaz, campo, método o 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, por ejemplo, de 0 a -- como valor predeterminado.
• Se cambia el motivo del error que se muestra de A a B.

Versiones secundarias

Las versiones secundarias solo introducen cambios retrocompatibles. 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 actualizarse automáticamente. Esto no provocará que el código falle. Puedes continúas usando tus bibliotecas cliente existentes.

Las versiones menores incluyen funciones nuevas o actualizaciones que no afectan el código existente. Si quieres usar estas funciones nuevas, actualiza tu 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 descontinuarse. Publicaremos avisos en el blog de desarrolladores cuando una versión está a punto de darse de baja. El el programa de baja se actualiza con la desactivación futura fechas.