La API de Search Ads 360 Reporting usa control de versiones semántico.
Hay versiones principales y secundarias, con el formato de
vMAJOR_MINOR Por ejemplo, v0_0 es la
primera versión principal y v0_1 la primera versión secundaria. El sufijo del
el número de versión indica el tipo de versión: para las versiones principales, siempre es cero,
y para versiones
secundarias, siempre es mayor que cero.
Versiones principales
Los lanzamientos importantes introducen cambios rotundos, es decir, cambios que no retrocompatible.
Cada versión principal tiene un extremo separado, por ejemplo:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
Al actualizar de una versión principal a otra, es posible que debas cambiar código antes de cambiar al nuevo extremo de la versión principal.
Si usas una biblioteca cliente, debes actualizarla a la versión más reciente. Las versiones principales nuevas proporcionan un 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.
- Cambiar el formato de URL en la definición HTTP.
- Cambiar los formatos de salida, por ejemplo, cambiar
0a--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.
Cuando se lanza una versión secundaria, el extremo que ya está en uso automáticamente. Esto no provoca que se dañe el código. Puedes continuar para usar tu biblioteca cliente existente.
Las versiones secundarias incluyen funciones nuevas o actualizaciones que no afectan las existentes código. Si quieres usar las funciones nuevas, debes actualizar tu biblioteca cliente a la última versión.
Puestas de sol
Cuando se programe la desactivación de una versión anterior de la API de Search Ads 360 Reporting, publicar un aviso en el Grupo de Google searchads-api-announcements.