Controllo delle versioni semantico
L'API Google Ads segue il controllo delle versioni semantico, in cui sono presenti
una versione principale e una secondaria. Il formato della versione è MAJOR.MINOR o
vMAJOR_MINOR. Ad esempio, v20_0 è una versione principale, mentre v20_1 è una versione secondaria.
Consulta le note di rilascio per le versioni precedenti.
Versioni principali
Le versioni principali introducono alcune modifiche che provocano errori e sono incompatibili con le versioni precedenti.
La versione terminerebbe con zero nel formato vX_0, dove X è il numero di versione principale.
Ogni versione principale ha un endpoint separato. In questo URL di esempio, 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 che devi consultare per correggere eventuali modifiche che causano interruzioni nel codice.
Ecco alcuni esempi di modifiche che causano interruzioni:
- Rimozione o ridenominazione di un servizio, un'interfaccia, un campo, un metodo o un valore enum.
- Modifica del tipo di un campo.
- Modifica del formato del nome di una risorsa.
- Modifica del formato dell'URL nella definizione HTTP.
- Modifica dei formati di output, ad esempio il passaggio da
0a--come valore predefinito. - Modifica del motivo dell'errore restituito da A a B.
Versioni secondarie
Le versioni secondarie 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 viene aggiornato automaticamente. Ciò non causerà l'interruzione del codice. Puoi continuare a utilizzare le librerie client esistenti.
Le versioni secondarie includono nuove funzionalità o aggiornamenti che non influiscono sul codice esistente. Se vuoi utilizzare queste nuove funzionalità, esegui l'upgrade delle librerie client all'ultima versione.
Tramonti
Periodicamente, le versioni precedenti dell'API Google Ads dovranno essere ritirate. Pubblicheremo avvisi sul blog per sviluppatori quando una versione sta per essere ritirata. Il programma di ritiro viene aggiornato con le date future di ritiro.