Con il rilascio di una nuova versione, a una versione ritirata viene assegnata una data di ritiro, 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 , mentre le versioni secondarie di 10 mesi.
- Dovrai eseguire al massimo due upgrade all'anno e non devi eseguirli in 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 ritiro per ogni versione disponibile, nonché le date di rilascio previste per le versioni future. Ti consigliamo di eseguire l'upgrade all'ultima versione il prima possibile dopo il rilascio. 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 API.
| Versione API | Data di uscita | Data di ritiro | Guida all'upgrade |
|---|---|---|---|
| Versioni rilasciate | |||
| v22 | 15 ottobre 2025 | Ottobre 2026 (provvisorio) | Eseguire l'upgrade dalla v21 alla v22 |
| v23 | 28 gennaio 2026 | Febbraio 2027 | Eseguire l'upgrade dalla v22 alla v23 |
| v23.1 | 25 febbraio 2026 | Febbraio 2027 | Eseguire l'upgrade dalla v23 alla v23.1 |
| v23.2 | 25 marzo 2026 | Febbraio 2027 | Eseguire l'upgrade dalla v23.1 alla v23.2 |
| v24 | 22 aprile 2026 | Maggio 2027 | Eseguire l'upgrade dalla v23.2 alla v24 |
| v24.1 | 13 maggio 2026 | Maggio 2027 | Eseguire l'upgrade dalla v24 alla v24.1 |
| v24.2 | 24 giugno 2026 | Giugno 2027 | Eseguire l'upgrade dalla v24.1 alla v24.2 |
| v25 | 22 luglio 2026 | Agosto 2027 | Eseguire l'upgrade dalla v24.2 alla 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 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:
- Apri API e servizi nella console Google Cloud.
- Fai clic su API Google Ads nella tabella.
- Nella scheda secondaria METRICHE, dovresti vedere le richieste recenti tracciate su ogni grafico. Puoi vedere a quali metodi 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. - (Facoltativo) Scegli il periodo di tempo per il quale vuoi visualizzare le richieste.
Differenze tra ritiro e ritiro
| Termine | Ritiro | Ritiro |
|---|---|---|
| Definizione | La versione ritirata è una versione non più recente. 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 finché non vengono ritirate,
ma i riferimenti alle versioni ritirate vengono evidenziati per indicare
che non sono più la versione più recente.
Ti consigliamo di eseguire l'upgrade all'ultima versione il prima possibile per usufruire delle nuove funzionalità. |
Devi eseguire l'upgrade dalle versioni ritirate immediatamente in
ordine per utilizzare l'API Google Ads.
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 è ritirare 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 ritirate smettono di funzionare dopo le date di ritiro. L'API Google Ads genererà un errore se tenti di accedere agli endpoint API delle versioni ritirate. |
| 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 ritirate in nessuna nuova versione della libreria client dopo le date di ritiro. |
| Assistenza | Forniamo assistenza regolare per le versioni ritirate. | Le versioni ritirate non sono più supportate dopo la data di ritiro. |
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.
Java
API Google Ads |
Libreria client per Java |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
v22 |
Min: 41.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: - |
v22 |
Min: 24.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: - |
v22 |
Min: 31.0.0Max: - |
Python
API Google Ads |
Libreria client per Python |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
v22 |
Min: 28.1.0Max: - |
Ruby
API Google Ads |
Libreria client per Ruby |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
v22 |
Min: 36.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: - |
v22 |
Min: 29.0.0Max: - |
Ritiri e modifiche delle funzionalità
Sebbene questa pagina si concentri sui cicli di vita a livello di versione API, i ritiri di singole funzionalità (ad esempio il ritiro delle campagne intelligenti) e le modifiche del flusso di lavoro 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 comportamentali nelle versioni attive, consulta la guida Ritiri di funzionalità e modifiche senza versione.