Ritiro e ritiro

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

• In un determinato momento sono disponibili al massimo tre versioni principali.
• Le versioni principali hanno una durata di circa 12 mesi, mentre le versioni secondarie durano 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 data di ritiro della versione è di almeno 20 settimane.

Le nostre librerie client supportano tutte le versioni disponibili di un servizio, pertanto puoi eseguire l'upgrade gradualmente specificando versioni diverse dei servizi utilizzati.

Orario

La tabella seguente elenca le date specifiche di ritiro e ritiro di 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 la sua release.

Versione API	Data di uscita	Data di ritiro	Data di ritiro	Guida all'upgrade
v18	16 ottobre 2024	Febbraio 2025	24 settembre 2025
v17.1	7 agosto 2024	Set/ott 2024	4 giugno 2025	Eseguire l'upgrade dalla versione 17 alla versione 18
v17	June 5, 2024	Set/ott 2024	4 giugno 2025	Eseguire l'upgrade dalla versione 17 alla versione 18
v16.1	24 aprile 2024	June 5, 2024	5 febbraio 2025	Eseguire l'upgrade dalla versione 16 alla versione 17
v16	21 febbraio 2024	June 5, 2024	5 febbraio 2025	Eseguire l'upgrade dalla versione 16 alla versione 17

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 API e servizi nella console Google Cloud.
2. Fai clic su API Google Ads nella tabella.
3. Nella sottoscheda METRICS, dovresti vedere le tue richieste recenti tracciate su ciascun 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.v18.services.GoogleAdsService.Mutate.
4. (Facoltativo) Scegli il periodo di tempo da visualizzare per le richieste.

Differenze tra ritiro e ritiro del servizio

Termine	Ritiro	Tramonto
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 comunque utilizzare le versioni ritirate fino al loro ritiro, ma i riferimenti alle versioni ritirate non sono evidenziati per indicare che non sono più le versioni più recenti. Ti invitiamo a eseguire l'upgrade alla versione più recente il prima possibile per beneficiare delle nuove funzionalità.	Per utilizzare l'API Google Ads, devi eseguire l'upgrade dalle versioni ritirate immediatamente. Ti consigliamo vivamente di eseguire l'upgrade alla versione più recente 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 continueranno a funzionare 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 smettono di funzionare dopo le rispettive date di ritiro. L'API Google Ads restituirà un errore se provi ad accedere agli endpoint API delle versioni ritirate.
Librerie client	Ai fini della fornitura di 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 nessuna 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 delle librerie client supportate

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

Ritiri di funzionalità

Monitora regolarmente il blog per sviluppatori di Google Ads per essere il primo a sapere delle prossime ritirate delle funzionalità.

La tabella seguente elenca i ritiri specifici delle funzionalità attualmente previsti per l'API Google Ads. Puoi trovare ulteriori dettagli su ogni ritiro nei post del blog collegati.

Funzionalità	Descrizione	Data di validità	Note aggiuntive
Modifiche imminenti alle dimensioni della pagina nell'API Google Ads	Quando la versione 16 verrà ritirata, non potrai più impostare il campo page_size quando effettui richieste GoogleAdsService.Search.	Febbraio 2025	Quando la versione 16 verrà ritirata, tutte le richieste GoogleAdsService.Search assumeranno una dimensione della pagina fissa di 10.000 righe.
Strategia di offerta basata su CPC ottimizzato	L'API Google Ads non supporta più l'impostazione del CPCO come strategia di offerta per le campagne sulla rete di ricerca e display.	Ottobre 2024	Le richieste di impostazione del enhanced_cpc_enabled campo su TRUE in una strategia di offerta generano un BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED errore. Le campagne esistenti con la strategia di offerta CPCO continueranno a essere pubblicate fino al 15 marzo 2025. Dopo questa data, verrà eseguita automaticamente la migrazione alla strategia Costo per clic (CPC) manuale.