Ritiro e dismissione

Con il rilascio di una nuova versione, a una versione ritirata viene assegnata una data di disattivazione, dopo la quale la versione non sarà più disponibile. Ecco alcune altre linee guida da tenere presenti:

• Ci impegniamo a mantenere disponibili al massimo cinque versioni principali contemporaneamente.
• Le versioni principali hanno una durata di circa 12 mesi—le versioni secondarie: 10 mesi.
• Dovrai eseguire al massimo due upgrade all'anno e non devi eseguire l'upgrade in un ordine sequenziale rigoroso. Ad esempio, puoi eseguire l'upgrade dalla versione (N) direttamente alla versione (N+2).

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 specifiche di ritiro e disattivazione per ogni versione disponibile e le date di rilascio previste per le versioni future. Ti consigliamo di eseguire l'upgrade alla versione più recente il prima possibile dopo il rilascio. La data provvisoria indica che la disattivazione potrebbe avvenire in qualsiasi momento del mese e le date potrebbero cambiare. Iscriviti al blog per ricevere promemoria sugli annunci di disattivazione delle versioni API.

Versione API	Data di uscita	Data di disattivazione	Guida all'upgrade
Versioni rilasciate
v21	6 agosto 2025	Agosto 2026 (provvisorio)	Eseguire l'upgrade da v20 a v21
v22	15 ottobre 2025	Ottobre 2026 (provvisorio)	Eseguire l'upgrade da v21 a v22
v23	28 gennaio 2026	Febbraio 2027	Eseguire l'upgrade da v22 a v23
v23.1	25 febbraio 2026	Febbraio 2027	Eseguire l'upgrade da v23 a v23.1
v23.2	25 marzo 2026	Febbraio 2027	Eseguire l'upgrade da v23.1 a v23.2
v24	22 aprile 2026	Maggio 2027	Eseguire l'upgrade da v23.2 a v24
v24.1	13 maggio 2026	Maggio 2027	Eseguire l'upgrade da v24 a v24.1
v24.2	24 giugno 2026	Giugno 2027	Eseguire l'upgrade da v24.1 a v24.2
v25	22 luglio 2026	Agosto 2027	Eseguire l'upgrade da v24.2 a v25
Versioni in uscita
v25.1	Agosto 2026	Agosto 2027
v25.2	Settembre 2026	Agosto 2027
v26	Ottobre 2026	Novembre 2027
v26.1*	Novembre 2026	Novembre 2027

* La versione v26.1 è designata come release facoltativa a causa della sovrapposizione con il periodo delle festività.

Visualizzare le versioni utilizzate dal progetto

Puoi visualizzare un elenco di metodi e servizi che il tuo progetto ha chiamato di recente 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 scheda secondaria METRICHE, dovresti vedere le richieste recenti tracciate su ogni grafico. Puoi vedere i metodi a cui hai inviato le 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.v25.services.GoogleAdsService.Mutate.
4. (Facoltativo) Scegli il periodo di tempo che vuoi visualizzare per le tue richieste.

Differenze tra ritiro e disattivazione

Termine	Ritiro	Disattivazione
Definizione	La versione ritirata è una versione non più la più recente. Una volta rilasciata una nuova versione, tutte le versioni precedenti verranno contrassegnate come ritirate.	La versione disattivata non può più essere utilizzata. Le richieste inviate a questa versione non andranno a buon fine a partire dalla data di disattivazione.
Implicazione	Puoi continuare a utilizzare le versioni ritirate finché non vengono disattivate, ma i riferimenti alle versioni ritirate vengono evidenziati per indicare che non sono più la versione più recente. Ti consigliamo di eseguire l'upgrade alla versione più recente il prima possibile per usufruire delle nuove funzionalità.	Per utilizzare l'API Google Ads, devi eseguire l'upgrade dalle versioni disattivate immediatamente in ordine. Ti consigliamo vivamente di eseguire l'upgrade alla versione più recente utilizzando la guida all'upgrade.
Sincronizzazione	In media, rilasciamo una nuova versione ogni 3-4 mesi, quindi la versione indicata verrà ritirata dopo circa 3-4 mesi.	Il nostro obiettivo è disattivare una versione 1 anno dopo il rilascio.
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, le nuove funzionalità non vengono aggiunte alle versioni ritirate.	Gli endpoint API per le versioni disattivate smettono di funzionare dopo le date di disattivazione. L'API Google Ads genererà un errore se tenti di accedere agli endpoint API delle versioni disattivate.
Librerie client	Per fornire librerie client compatte, non includeremo più le 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 API disattivate in nessuna nuova versione della libreria 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 delle librerie client supportate

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

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

Ritiri e modifiche delle funzionalità

Sebbene questa pagina si concentri sui cicli di vita a livello di versione API, i singoli ritiri di funzionalità (ad esempio il ritiro delle campagne intelligenti) e le modifiche del workflow senza versione (ad esempio i nuovi requisiti di budget delle campagne Demand Gen) vengono monitorati separatamente.

Per controllare i cicli di vita delle funzionalità in uscita e le modifiche del comportamento nelle versioni attive, consulta la guida Ritiri di funzionalità e modifiche senza versione.