Control de versiones semántico
La API de Google Ads sigue el control de versiones semántico con un número de versión principal y uno secundario. Las versiones se escriben como MAJOR.MINOR o vMAJOR.MINOR.
Por ejemplo, v26.0 (o v26) es una versión principal, mientras que v26.1 es una versión secundaria.
Consulta las notas de la versión para obtener detalles sobre las versiones actuales y anteriores.
Versiones principales
Las versiones de actualización principales presentan cambios rotundos que no son compatibles con versiones anteriores. La
versión inicial de una versión principal termina en cero (vX.0 o vX, donde X es
el número de versión principal).
Cada versión principal tiene una ruta de extremo de REST y gRPC independiente (vX), que no
incluye el sufijo de la versión secundaria. En la siguiente URL, X es el número de versión principal (por ejemplo, v26):
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 de la biblioteca cliente que admita la nueva versión principal. Cuando se lanza una versión principal, proporcionamos una guía de actualización para ayudarte a resolver cualquier cambio rotundo 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 el formato del nombre de un recurso
- Cambiar el formato de la URL en la definición de HTTP
- Cambiar los formatos de salida, como los valores predeterminados
- Cambiar el motivo del error que se devuelve de A a B
Versiones secundarias
Las versiones secundarias solo presentan cambios retrocompatibles. Para una versión secundaria,
vMAJOR.MINOR tiene un número MINOR mayor que cero (por ejemplo,
v26.1).
Cuando se lanza una versión secundaria, el extremo de la versión principal existente
(https://googleads.googleapis.com/vX) se actualiza automáticamente in situ. No
necesitas cambiar la ruta de la versión en las URLs de tus extremos, y el código existente
seguirá funcionando sin interrupciones.
Las versiones secundarias agregan funciones o actualizaciones que no afectan tu código existente. Para usar campos o funciones de una versión secundaria con una biblioteca cliente, actualiza la biblioteca cliente a una versión que incluya las definiciones de la versión secundaria.
Baja y descontinuación
Periódicamente, las versiones anteriores de la API de Google Ads se dan de baja y, luego, se desactivan:
- Obsoleta: Cuando se lanza una versión principal (como
v26), todas las versiones principales anteriores se marcan como obsoletas. Las llamadas a la API a las versiones obsoletas siguen funcionando hasta su fecha de baja, y las versiones existentes de la biblioteca cliente siguen admitiéndolas, aunque las versiones posteriores de la biblioteca cliente omiten las versiones obsoletas de la API para reducir el tamaño del paquete. - Desactivación: Una versión se inhabilita en su fecha de desactivación y todas las llamadas a la API a su extremo fallan.
Publicamos anuncios en el blog para desarrolladores antes de que las versiones dejen de estar disponibles. Consulta el programa de baja y descontinuación para conocer las fechas de descontinuación activas, dadas de baja y programadas.