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 alla volta.
- Le versioni principali hanno una durata di circa 12 mesi, mentre le versioni secondarie hanno una durata di 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 all'ultima versione non appena possibile dopo la sua uscita. La data provvisoria indica che il ritiro potrebbe avvenire in qualsiasi momento del mese e 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 | Guida all'upgrade |
|---|---|---|---|
| Versioni di release | |||
| v22 | 15 ottobre 2025 | Ottobre 2026 | Eseguire l'upgrade dalla versione 21 alla versione 22 |
| v23 | 28 gennaio 2026 | Febbraio 2027 | Esegui l'upgrade dalla versione 22 alla versione 23 |
| v23.1 | 25 febbraio 2026 | Febbraio 2027 | Esegui l'upgrade dalla versione 23 alla versione 23.1 |
| v23.2 | 25 marzo 2026 | Febbraio 2027 | Esegui l'upgrade dalla versione 23.1 alla versione 23.2 |
| v24 | 22 aprile 2026 | Maggio 2027 | Esegui l'upgrade dalla versione 23.2 alla versione 24 |
| v24.1 | 13 maggio 2026 | Maggio 2027 | Esegui l'upgrade dalla versione 24 alla versione 24.1 |
| v24.2 | 24 giugno 2026 | Giugno 2027 | Esegui l'upgrade dalla versione 24.1 alla versione 24.2 |
| v25 | 22 luglio 2026 | Agosto 2027 | Esegui l'upgrade dalla versione 24.2 alla versione 25 |
| v25.1 | 19 agosto 2026 | Agosto 2027 | Eseguire l'upgrade dalla versione 25 alla versione 25.1 |
| v25.2 | 23 settembre 2026 | Agosto 2027 | Esegui l'upgrade dalla versione 25.1 alla versione 25.2 |
| Versioni future | |||
| v26 | Ottobre 2026 | Novembre 2027 | |
| v26.1 | Ottobre 2026 | Novembre 2027 | |
| v26.2 | Novembre 2026 | Novembre 2027 | |
| 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 v26.3 e v30.3 sono designate come release facoltative a causa della sovrapposizione con il periodo delle festività.
Visualizza le versioni utilizzate dal progetto
Puoi visualizzare un elenco di metodi e servizi chiamati di recente dal tuo progetto utilizzando la console Google Cloud:
- Apri API e servizi nella console Google Cloud.
- Fai clic su API Google Ads nella tabella.
- 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.v25.services.GoogleAdsService.Mutate. - (Facoltativo) Scegli il periodo di tempo che vuoi visualizzare per le tue richieste.
Differenze tra ritiro e fine del ciclo di vita
| Termine | Ritiro | Tramonto |
|---|---|---|
| Definizione | La versione deprecata è una versione che non è l'ultima. Una volta rilasciata una nuova versione, tutte le versioni precedenti verranno contrassegnate come ritirate. | La versione ritirata 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 vengono 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 | In media, rilasciamo una nuova versione ogni 3-4 mesi, quindi la versione indicata verrà ritirata dopo circa 3-4 mesi. | 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, 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 delle API ritirate in qualsiasi nuova versione della libreria client dopo le date di ritiro. |
| 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 release principale dell'API Google Ads (ad esempio v25). Per visualizzare la versione della libreria client richiesta per le release minori, consulta il log delle modifiche collegato.
Java
API Google Ads |
Libreria client per Java |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
API Google Ads |
Libreria client per .NET |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
API Google Ads |
Libreria client per PHP |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
API Google Ads |
Libreria client per Python |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
API Google Ads |
Libreria client per Ruby |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
API Google Ads |
Libreria client per Perl |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
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 ai workflow senza versione (come i nuovi requisiti di budget della campagna Demand Gen) vengono monitorati separatamente.
Per controllare i cicli di vita delle funzionalità imminenti e i cambiamenti di comportamento nelle versioni attive, consulta la guida Deprecazioni delle funzionalità e modifiche senza versione.