Controllo delle versioni semantico
L'API Google Ads segue il controllo delle versioni semantico in cui è presente una versione principale e una secondaria. Il formato della versione è MAJOR.MINOR o
vMAJOR_MINOR. Ad esempio, v16_0 è una versione principale, mentre
v16_1 è una versione secondaria.
Consulta le note di rilascio per le versioni precedenti.
Versioni principali
Le versioni di release principali introducono alcune modifiche non compatibili con le versioni precedenti.
La versione terminerà con zero con il formato vX_0, dove X è il numero di versione principale.
Ogni versione principale ha un endpoint separato. Questo è un esempio dell'URL in cui
X è il numero di versione principale.
https://googleads.googleapis.com/vX
Se esegui l'upgrade da una versione principale precedente, il codice potrebbe richiedere modifiche quando passi al nuovo endpoint della versione principale. Se utilizzi le nostre librerie client, esegui l'upgrade alla versione più recente. Quando viene rilasciata una versione principale, forniamo una guida alla migrazione da seguire per correggere eventuali modifiche che provocano errori nel codice.
Esempi di modifiche che provocano errori includono:
- Rimozione o ridenominazione di un servizio, di un'interfaccia, di un campo, di un metodo o di un valore di enumerazione.
- Modifica del tipo di campo.
- Modifica del formato del nome di una risorsa.
- Modifica del formato dell'URL nella definizione HTTP.
- Modifica dei formati di output, ad esempio cambiando da
0a--come valore predefinito. - Modifica del motivo dell'errore restituito da A a B.
Versioni secondarie
Le versioni minori introducono solo modifiche compatibili con le versioni precedenti. Per una versione secondaria, vMAJOR_MINOR avrebbe un numero MINOR maggiore di zero.
Quando viene rilasciata una versione secondaria, l'endpoint già in uso verrà aggiornato automaticamente. Ciò non causerà interruzioni del codice. Puoi continuare a utilizzare le librerie client esistenti.
Le versioni secondarie includono nuove funzionalità o aggiornamenti che non interessano il codice esistente. Se vuoi utilizzare queste nuove funzionalità, esegui l'upgrade delle librerie client alla versione più recente.
Tramonti
Periodicamente dovranno essere ritirate le versioni precedenti dell'API Google Ads. Pubblicheremo notifiche nel blog per sviluppatori quando una versione sta per essere ritirata. La pianificazione del ritiro viene aggiornata con date di ritiro future.