Ritiro e ritiro

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 presente:

  • Ci impegniamo a mantenere disponibili al massimo quattro versioni principali contemporaneamente.
  • Le versioni principali hanno un ciclo di vita di circa 12 mesi, mentre le versioni secondarie di 10 mesi.
  • Dovrai eseguire al massimo due upgrade all'anno e non devi eseguire l'upgrade in ordine sequenziale rigoroso. Ad esempio, puoi eseguire l'upgrade dalla versione (N) direttamente alla versione (N+2).
  • La sovrapposizione tra la data di rilascio di tutte le librerie client per la versione più recente e la versione da ritirare è di almeno 20 settimane.

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 fine del ciclo di vita 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 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 APIData di uscitaData di ritiroData di ritiroGuida all'upgrade
v216 agosto 2025Eseguire l'upgrade dalla versione 20 alla versione 21
v20.16 agosto 2025Giugno 2026 (data provvisoria)Eseguire l'upgrade dalla versione 19 alla versione 20
v204 giugno 2025Giugno 2026 (data provvisoria)Eseguire l'upgrade dalla versione 19 alla versione 20
v19.26 agosto 2025 Febbraio 2026 (data provvisoria)Upgrade dalla versione 18 alla versione 19
v19.116 Aprile 2025 Febbraio 2026 (data provvisoria)Upgrade dalla versione 18 alla versione 19
v1926 febbraio 2025 Febbraio 2026 (data provvisoria)Upgrade dalla versione 18 alla versione 19
v1816 ottobre 2024Giugno 202520 agosto 2025

Visualizzare le versioni utilizzate dal progetto

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

  1. Apri la pagina API e servizi nella console Google Cloud.
  2. Fai clic su API Google Ads nella tabella.
  3. Nella scheda secondaria 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.v21.services.GoogleAdsService.Mutate.
  4. (Facoltativo) Scegli il periodo di tempo che vuoi visualizzare per le tue richieste.

Differenze tra ritiro e fine del ciclo di vita

TermineRitiroTramonto
Definizione La versione ritirata è 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 disattivazione.
Implicazione Puoi comunque utilizzare le versioni ritirate fino al loro ritiro, ma i riferimenti alle versioni ritirate non sono più evidenziati per indicare 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 il suo rilascio.
API Gli endpoint API per le versioni ritirate funzionano ancora come di consueto.

Puoi accedere ai nostri endpoint API utilizzando le nostre librerie client, REST e così via. Tuttavia, le nuove funzionalità non vengono aggiunte alle versioni ritirate.

 Gli endpoint API per le versioni ritirate smetteranno 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 Ai fini della fornitura di 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 dell'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.

Java

Libreria client per Java
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -

C#

Libreria client per .NET
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: 23.0.0

PHP

Libreria client per PHP
v21 Min: 31.0.0
Max: -
v20 Min: 28.0.0
Max: -
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: 30.0.0

Python

Libreria client per Python
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -

Ruby

Libreria client per Ruby
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -
v18 Min: 31.0.0
Max: -

Perl

Libreria client per Perl
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: 28.0.0

Ritiri di funzionalità

Monitora regolarmente il blog per sviluppatori di Google Ads per scoprire in anteprima i prossimi ritiri delle funzionalità.

La tabella seguente elenca i ritiri di funzionalità specifici pianificati per l'API Google Ads. Puoi trovare maggiori dettagli su ogni ritiro nei post del blog collegati.

Funzionalità Descrizione Data di validità Note aggiuntive
Ambiente di conversione che influisce sul rendimento della campagna per app A partire dal 30 settembre 2025, inizieremo a implementare gradualmente una modifica ai modelli di offerta, consentendo loro di utilizzare i dati sull'ambiente di conversione inclusi nelle conversioni importate per ottimizzare il rendimento della campagna. 3 ottobre 2025 Per maggiori dettagli, consulta il nostro post del blog.
Le conversioni possono includere sia valori `gclid` sia `gbraid`. A partire dal 3 ottobre 2025, le conversioni importate non restituiranno più un errore `VALUE_MUST_BE_UNSET` se sono impostati sia i campi `gclid` sia `gbraid`. 3 ottobre 2025 Per maggiori dettagli, consulta il nostro post del blog.