Ritiro e dismissione

L'API Google Ads mantiene più versioni principali attive in qualsiasi momento e una versione viene considerata deprecata solo se è contrassegnata esplicitamente come tale. Pubblichiamo le date di rilascio e di ritiro in anticipo per aiutarti a pianificare gli upgrade. Dopo la data di ritiro di una versione, questa non è più disponibile. Ecco alcune linee guida chiave per il controllo delle versioni da tenere presenti:

• Ci impegniamo a mantenere disponibili al massimo cinque versioni principali alla volta.
• Le versioni principali hanno una durata di circa 12 mesi. La durata delle versioni API secondarie non viene monitorata separatamente. Le versioni secondarie condividono la stessa data di ritiro della versione principale corrispondente.
• Ogni versione secondaria aggiorna in modo incrementale la versione principale corrispondente.
• Tutte le chiamate API a una versione principale specifica vengono sempre indirizzate all'ultima versione secondaria corrispondente. L'API Google Ads non supporta la chiamata di versioni secondarie specifiche.
• Dovrai eseguire al massimo due upgrade all'anno e non è necessario eseguire l'upgrade in un ordine sequenziale rigoroso, ad esempio puoi eseguire l'upgrade dalla versione (N) direttamente alla versione (N+2).
• Se non hai mai utilizzato l'API Google Ads, ti consigliamo di iniziare con la versione 26.

Le nostre librerie client supportano tutte le versioni disponibili di un servizio, quindi puoi eseguire l'upgrade gradualmente specificando versioni diverse dei servizi utilizzati.

Orario

La tabella seguente elenca le date di rilascio e di ritiro di ogni versione disponibile, nonché le date di rilascio previste per le versioni future. Ti consigliamo di eseguire l'upgrade all'ultima versione non appena possibile dopo la sua uscita. La data provvisoria indica che il ritiro potrebbe avvenire in qualsiasi momento di quel mese e che le date potrebbero cambiare. Iscriviti al blog per ricevere promemoria sugli annunci di ritiro delle versioni dell'API.

Versione API	Data di uscita	Data di ritiro	Modifiche che provocano un errore e upgrade	Funzionalità e aggiornamenti	Tabella delle differenze dei proto
Versioni di release
v23	28 gennaio 2026	Febbraio 2027	Modifiche che provocano un errore della versione 23 (guida all'upgrade)	Funzionalità e aggiornamenti della versione 23	Differenze tra i proto v22 e v23
v23.1	25 febbraio 2026	Febbraio 2027	Nessuna (release secondaria)	Funzionalità e aggiornamenti della versione 23.1	Differenze tra i proto v22 e v23
v23.2	25 marzo 2026	Febbraio 2027	Nessuna (release secondaria)	Funzionalità e aggiornamenti della versione 23.2	Differenze tra i proto v22 e v23
v23.3	24 giugno 2026	Febbraio 2027	Nessuna (release secondaria)	Funzionalità e aggiornamenti della versione 23.3	Differenze tra i proto v22 e v23
v24	22 aprile 2026	Maggio 2027	Modifiche che provocano un errore della versione v24 (guida all'upgrade)	Funzionalità e aggiornamenti della versione 24	Differenze tra i proto v23 e v24
v24.1	13 maggio 2026	Maggio 2027	Nessuna (release secondaria)	Funzionalità e aggiornamenti della versione 24.1	Differenze tra i proto v23 e v24
v24.2	24 giugno 2026	Giugno 2027	Nessuna (release secondaria)	Funzionalità e aggiornamenti della versione 24.2	Differenze tra i proto v23 e v24
v25	22 luglio 2026	Agosto 2027	Modifiche che provocano un errore della versione 25 (guida all'upgrade)	Funzionalità e aggiornamenti della versione 25	Differenze tra i proto v24 e v25
v25.1	19 agosto 2026	Agosto 2027	Nessuna (release secondaria)	Funzionalità e aggiornamenti della versione 25.1	Differenze tra i proto v24 e v25
v25.2	23 settembre 2026	Agosto 2027	Nessuna (release secondaria)	Funzionalità e aggiornamenti della versione 25.2	Differenze tra i proto v24 e v25
v26 (versione più recente)	14 ottobre 2026	Novembre 2027	Modifiche che provocano un errore della versione 26 (guida all'upgrade)	Funzionalità e aggiornamenti della versione 26	Differenze tra i proto v25 e v26
v26.1	28 ottobre 2026	Novembre 2027	Nessuna (release secondaria)	Funzionalità e aggiornamenti della versione 26.1	Differenze tra i proto v25 e v26
v26.2	11 novembre 2026	Novembre 2027	Nessuna (release secondaria)	Funzionalità e aggiornamenti della versione 26.2	Differenze tra i proto v25 e v26
Versioni future
v26.3*	Dicembre 2026	Novembre 2027
v27	Gennaio 2027	Febbraio 2028
v27.1	Febbraio 2027	Febbraio 2028
v27.2	Febbraio 2027	Febbraio 2028
v27.3	Marzo 2027	Febbraio 2028
v27.4	Marzo 2027	Febbraio 2028
v28	Aprile 2027	Maggio 2028
v28.1	Aprile 2027	Maggio 2028
v28.2	Maggio 2027	Maggio 2028
v28.3	Maggio 2027	Maggio 2028
v28.4	Giugno 2027	Maggio 2028
v28.5	Giugno 2027	Maggio 2028
v29	Luglio 2027	Agosto 2028
v29.1	Luglio 2027	Agosto 2028
v29.2	Agosto 2027	Agosto 2028
v29.3	Agosto 2027	Agosto 2028
v29.4	Settembre 2027	Agosto 2028
v29.5	Settembre 2027	Agosto 2028
v30	Ottobre 2027	Novembre 2028
v30.1	Ottobre 2027	Novembre 2028
v30.2	Novembre 2027	Novembre 2028
v30.3*	Dicembre 2027	Novembre 2028

* Le versioni 26.3 e 30.3 sono considerate facoltative a causa della sovrapposizione con il periodo delle festività.

Visualizza le versioni utilizzate dal tuo progetto

Puoi visualizzare un elenco di metodi e servizi chiamati di recente dal tuo progetto utilizzando la console Google Cloud:

1. Apri API e servizi nella console Google Cloud.
2. Fai clic su API Google Ads nella tabella.
3. Nella sottoscheda METRICHE, dovresti vedere le tue richieste recenti tracciate su ogni grafico. Puoi vedere a quali metodi hai inviato richieste nella tabella Metodi. Il nome del metodo include una versione dell'API Google Ads, un servizio e un nome del metodo, ad esempio google.ads.googleads.v26.services.GoogleAdsService.Mutate.
4. (Facoltativo) Scegli il periodo di tempo che vuoi visualizzare per le tue richieste.

Differenze tra ritiro e ritiro definitivo

Termine	Ritiro	Tramonto
Definizione	Una versione è considerata deprecata solo se è contrassegnata esplicitamente come deprecata. L'API Google Ads ha più versioni principali attive in qualsiasi momento.	La versione disattivata non può più essere utilizzata. Le richieste inviate a questa versione non andranno a buon fine a partire dalla data di ritiro.
Implicazione	Puoi continuare a utilizzare le versioni ritirate fino al loro ritiro, ma i riferimenti alle versioni ritirate non sono evidenziati per mostrare che non sono più l'ultima versione. Ti consigliamo di eseguire l'upgrade all'ultima versione il prima possibile per usufruire delle nuove funzionalità.	Per utilizzare l'API Google Ads, devi eseguire l'upgrade dalle versioni ritirate immediatamente. Ti consigliamo vivamente di eseguire l'upgrade all'ultima versione utilizzando la guida all'upgrade.
Tempistiche	Le date di ritiro vengono pubblicate in anticipo e una versione viene considerata deprecata solo se è esplicitamente contrassegnata come tale.	Il nostro obiettivo è ritirare una versione un anno dopo la sua uscita.
API	Gli endpoint API per le versioni ritirate continuano a funzionare come di consueto. Puoi accedere ai nostri endpoint API utilizzando le nostre librerie client e REST. Tuttavia, alle versioni ritirate non vengono aggiunte nuove funzionalità.	Gli endpoint API per le versioni ritirate smettono di funzionare dopo le date di ritiro. L'API Google Ads genererà un errore se provi ad accedere agli endpoint API delle versioni ritirate.
Librerie client	Al fine di fornire librerie client compatte, interromperemo l'inclusione delle versioni API ritirate in una nuova versione della libreria client dopo la data di ritiro. In questo modo, puoi risparmiare spazio quando incorpori le nostre librerie client nei tuoi progetti.	Le librerie client non supportano più le versioni delle API disattivate in nessuna nuova versione delle librerie client dopo le date di disattivazione.
Assistenza	Forniamo assistenza regolare per le versioni ritirate.	Le versioni disattivate non sono più supportate dopo la data di disattivazione.

Versioni della libreria client supportate

La tabella mostra quali librerie client funzionano con quali versioni dell'API.

La versione minima della libreria client elencata è sufficiente per la versione principale dell'API Google Ads (ad esempio v26). Per visualizzare la versione della libreria client richiesta per le release secondarie, consulta il log delle modifiche collegato.

Funzionalità deprecate e modifiche

Sebbene questa pagina si concentri sui cicli di vita a livello di versione dell'API, i ritiri di singole funzionalità (come il ritiro delle campagne intelligenti) e le modifiche al flusso di lavoro senza versione (come i nuovi requisiti di budget delle campagne Demand Gen) vengono monitorati separatamente.

Per controllare i cicli di vita delle funzionalità imminenti e i comportamenti diversi tra le versioni attive, consulta la guida Ritiro delle funzionalità e modifiche non incluse nelle versioni.