Controllo delle versioni

Controllo delle versioni semantiche

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, v18_0 è una versione principale, mentre v18_1 è una versione secondaria.

Consulta le note di rilascio per le versioni precedenti.

Versioni principali

Le versioni principali delle release introducono alcune modifiche che non sono compatibili con le versioni precedenti e che provocano errori. La versione termina con zero nel formato vX_0, dove X è il numero della versione principale.

Ogni versione principale ha un endpoint separato. Questo è un esempio di URL in cuiX è il numero della versione principale.

https://googleads.googleapis.com/vX

Se esegui l'upgrade da una versione principale precedente, il codice potrebbe richiedere modifiche quando passi all'endpoint della nuova versione principale. Se utilizzi le nostre librerie client, esegui l'upgrade alla versione più recente. Quando viene rilasciata una versione principale, ti forniremo una guida alla migrazione che dovrai seguire per correggere eventuali modifiche incompatibili nel codice.

Ecco alcuni esempi di modifiche che comportano interruzioni:

• Rimozione o ridenominazione di un servizio, un'interfaccia, un campo, un metodo o un valore di 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 0 a -- 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 minore,vMAJOR_MINOR avrà un numero MINOR maggiore di zero.

Quando viene rilasciata una versione secondaria, l'endpoint già in uso verrà aggiornato automaticamente. Il codice non verrà interrotto. Puoi continuare a utilizzare le librerie client esistenti.

Le versioni minori includono nuove funzionalità o aggiornamenti che non influiscono sul codice esistente. Se vuoi utilizzare queste nuove funzionalità, esegui l'upgrade delle librerie client alla versione più recente.

Tramonti

Periodicamente, le versioni precedenti dell'API Google Ads dovranno essere ritirate. Pubblicheremo notifiche sul blog per sviluppatori quando una versione sta per essere ritirata. Il programma di ritiro viene aggiornato con le date di ritiro future.