La API de informes de Search Ads 360 utiliza el control de versiones semántico.
Hay versiones principales y secundarias, con el formato vMAJOR_MINOR. Por ejemplo, v0_0 es la primera versión principal y v0_1 es la primera versión secundaria. El sufijo del número de versión indica el tipo de versión: en las versiones principales siempre es cero y en las versiones secundarias siempre es mayor que cero.
Versiones principales
Las versiones principales introducen cambios rotundos, es decir, cambios que no son compatibles con versiones anteriores.
Cada versión principal tiene un extremo independiente, por ejemplo:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
Cuando actualizas de una versión principal a otra, es posible que debas cambiar tu código antes de cambiar al extremo de la versión principal nueva.
Si usas una biblioteca cliente, debes actualizar a la versión más reciente. Las nuevas versiones principales proporcionan una guía de migración para ayudarte a 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
- Cambiando el formato de URL en la definición HTTP.
- Cambiar los formatos de salida, como cambiar
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.
Cuando se lanza una versión secundaria, el extremo que ya está en uso se actualiza automáticamente. Esto no hace que se rompa el código. Puedes seguir usando tu biblioteca cliente existente.
Las versiones secundarias incluyen funciones nuevas o actualizaciones que no afectan el código existente. Si quieres usar las funciones nuevas, debes actualizar tu biblioteca cliente a la versión más reciente.
Puestas de sol
Cuando se programa la desactivación de una versión anterior de la API de informes de Search Ads 360, publicamos un aviso en el Grupo de Google searchads-api-announcements.