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 una durata di circa 12 mesi—le versioni secondarie: 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).
  • La sovrapposizione tra la data di rilascio di tutte le librerie client per la versione più recente e la versione da disattivare è 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 disattivazione per ogni versione disponibile e 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 la disattivazione potrebbe avvenire in qualsiasi momento del mese e le date potrebbero cambiare. Iscriviti al blog per ricevere promemoria degli annunci di disattivazione delle versioni API.

Versione APIData di uscitaData di disattivazioneGuida all'upgrade
Versioni rilasciate
v204 giugno 2025Giugno 2026 (provvisorio)Eseguire l'upgrade da v19 a v20
v20.16 agosto 2025Giugno 2026 (provvisorio)Eseguire l'upgrade da v19 a v20
v216 agosto 2025Agosto 2026 (provvisorio)Eseguire l'upgrade da v20 a v21
v2215 ottobre 2025Ottobre 2026 (provvisorio)Eseguire l'upgrade da v21 a v22
v2328 gennaio 2026Febbraio 2027Eseguire l'upgrade da v22 a v23
Versioni in uscita
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 Aprile 2026 Maggio 2027  
v24.1 Maggio 2026 Maggio 2027  
v24.2 Giugno 2026 Maggio 2027  
v25 Luglio 2026 Agosto 2027  
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 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.v23.services.GoogleAdsService.Mutate.
  4. (Facoltativo) Scegli il periodo di tempo per il quale vuoi visualizzare le richieste.

Differenze tra ritiro e disattivazione

TermineRitiroDisattivazione
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.
Implicazioni Puoi continuare a utilizzare le versioni ritirate fino alla loro disattivazione, 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 disattivate 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 è disattivare una versione 1 anno dopo il rilascio.
API Gli endpoint API per le versioni ritirate continuano a funzionare normalmente.

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 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.

Java

Libreria client per Java
v23 Min: 42.1.0
Max: -
v22 Min: 41.1.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -

C#

Libreria client per .NET
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -

PHP

Libreria client per PHP
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 26.1.0
Max: -

Python

Libreria client per Python
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ruby

Libreria client per Ruby
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -

Perl

Libreria client per Perl
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ritiri di funzionalità

Consulta regolarmente il blog per sviluppatori di Google Ads per essere il primo a conoscere i prossimi ritiri di funzionalità.

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

Funzionalità Descrizione Data di validità Note aggiuntive
Modifiche al supporto di Customer Match

A partire dal 1° aprile 2026, i token sviluppatore senza richieste recenti di Customer Match devono utilizzare l'API Data Manager per i workflow di Customer Match.

1° aprile 2026 Per ulteriori dettagli, consulta il nostro post del blog.
Modifiche al supporto per gli attributi di sessione e gli indirizzi IP A partire dal 2 febbraio 2026, l'API Google Ads non accetterà più nuovi utenti che utilizzano i dati relativi agli attributi di sessione o agli indirizzi IP nelle importazioni delle conversioni. Gli utenti esistenti devono eseguire la migrazione all'API Data Manager. 2 febbraio 2026 Per ulteriori dettagli, consulta il nostro post del blog.
Ritiro degli annunci di sola chiamata A partire da gennaio 2026, non sarà più possibile creare nuovi annunci di sola chiamata. Gli annunci di sola chiamata esistenti smetteranno di essere pubblicati a febbraio 2027 e il supporto API verrà rimosso. Gli inserzionisti devono utilizzare gli annunci adattabili della rete di ricerca con asset di chiamata invece. Gennaio 2026 Per ulteriori dettagli, consulta il nostro post del blog.