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, v25.0 (o v25) es una versión principal, mientras que v25.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 principales introducen cambios rotundos que son incompatibles con versiones anteriores. El lanzamiento inicial de una versión principal termina en cero (vX.0 o vX, donde X es el número de la versión principal).
Cada versión principal tiene una ruta de extremo 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, v25):
https://googleads.googleapis.com/vX
Si actualizas desde una versión principal anterior, es posible que tu código requiera cambios cuando cambies al nuevo extremo de la 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 que interrumpa 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 de un nombre de recurso
- Se cambió el formato de la URL en la definición de HTTP.
- Cambiar los formatos de salida, como los valores predeterminados
- Se cambió el motivo del error que se devolvió de A a B.
Versiones secundarias
Las versiones secundarias solo introducen cambios retrocompatibles. En el caso de una versión secundaria, vMAJOR.MINOR tiene un número de MINOR mayor que cero (por ejemplo, v25.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 es necesario que cambies la ruta de la versión en las URLs de los extremos, y el código existente sigue 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 tu biblioteca cliente a una versión que incluya las definiciones de la versión secundaria.
Bajas y descontinuaciones
Periódicamente, se dan de baja las versiones anteriores de la API de Google Ads y, luego, se desactivan:
- Obsoleto: Cuando se lanza una versión principal (como
v25), todas las versiones principales anteriores se marcan como obsoletas. Las llamadas a la API de versiones obsoletas seguirán realizándose correctamente hasta la fecha de baja, y las versiones existentes de la biblioteca cliente seguirán admitiéndolas, aunque las versiones posteriores de la biblioteca cliente omitirán las versiones obsoletas de la API para reducir el tamaño del paquete. - Desactivación: Una versión se inhabilita en la fecha de desactivación y fallan todas las llamadas a la API a su extremo.
Publicamos anuncios en el blog para desarrolladores antes de que se descontinúen las versiones. Consulta el programa de baja y descontinuación para conocer las fechas de descontinuación activas, las fechas de baja y las fechas de descontinuación programadas.