Controllo delle versioni

Controllo delle versioni semantico

L'API Google Ads segue il controllo delle versioni semantico in cui è presente un una versione maggiore e una in quella minore. Il formato della versione è MAJOR.MINOR o vMAJOR_MINOR. Ad esempio, v17_0 è una versione principale, mentre v17_1 è una versione secondaria.

Consulta le note di rilascio per conoscere le versioni precedenti.

Versioni principali

Le versioni di release principali introducono alcune modifiche che provocano errori e non compatibili con le versioni precedenti. La versione terminerà con zero con il formato vX_0, dove X è il valore principale numero di versione.

Ogni versione principale ha un endpoint separato. Questo è un esempio di 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 quando passi al nuovo endpoint della versione principale. Se utilizzi le nostre librerie client, quindi esegui l'upgrade alla versione più recente. Quando sarà rilasciata una versione principale, forniremo una guida alla migrazione che per correggere eventuali modifiche che provocano un errore nel codice.

Ecco alcuni esempi di modifiche che provocano un errore:

• 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 della risorsa.
• Modifica del formato dell'URL nella definizione HTTP.
• Modifica dei formati di output, ad esempio da 0 a -- 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 minore, vMAJOR_MINOR avrebbe un numero MINOR maggiore di zero.

Quando viene rilasciata una versione secondaria, l'endpoint già in uso vengono aggiornate automaticamente. Ciò non causerà errori nel codice. Puoi continueranno a utilizzare le librerie client esistenti.

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

Tramonti

Periodicamente, le versioni precedenti dell'API Google Ads dovranno essere ritirate. Pubblicheremo le notifiche sul blog per sviluppatori quando una versione sta per essere ritirata. La la pianificazione del ritiro viene aggiornata con il ritiro futuro date.