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. Todas las llamadas a la API a una versión principal específica siempre se dirigen a la versión secundaria correspondiente más reciente, y la API de Google Ads no admite llamadas a versiones secundarias específicas.
No es necesario que cambies la ruta de acceso de la versión en las URLs de tus extremos, y el código existente
seguirá funcionando sin interrupciones. La vida útil de las versiones secundarias no se
registra por separado. En cambio, las versiones secundarias comparten la misma fecha de baja que su
versión principal correspondiente.
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
La API de Google Ads mantiene varias versiones principales activas en cualquier momento. De forma periódica, las versiones anteriores dejan de estar disponibles y, luego, se eliminan:
- Obsoleta: Una versión se considera obsoleta solo si se marca explícitamente como tal. Las llamadas a la API a las versiones obsoletas siguen funcionando correctamente hasta la fecha de descontinuación.
- Baja: Una versión se inhabilita en su fecha de baja 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.