Ritiro e ritiro

Con il rilascio di una nuova versione, a una versione deprecata viene data una data di ritiro, dopo la quale la versione non sarà più disponibile. Di seguito sono riportate altre linee guida da tenere presente:

• Sono disponibili al massimo tre versioni principali contemporaneamente.
• Le versioni principali hanno una durata di circa 12 mesi mentre le versioni minori hanno una durata di 10 mesi.
• Dovrai eseguire al massimo due upgrade all'anno senza dover 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 in cui vengono rilasciate 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 gradualmente l'upgrade specificando diverse versioni dei servizi utilizzati.

Orario

La tabella riportata di seguito elenca le date specifiche di ritiro e ritiro per ogni versione disponibile, nonché le date di rilascio previste per le versioni future. Ti invitiamo a eseguire l'upgrade alla versione più recente non appena possibile dopo il rilascio.

Versione API	Data di uscita	Data di ritiro	Data di ritiro	Guida all'upgrade
v18	Set/ottobre 2024	Gen/Feb 2025	Settembre 2025
v17.1	Lug/Ago 2024	Set/ottobre 2024	Maggio 2025
v17	Maggio/Giu 2024	Set/ottobre 2024	Maggio 2025
v16.1	24 aprile 2024	Maggio/Giu 2024	Gennaio 2025
v16	21 febbraio 2024	Maggio/Giu 2024	Gennaio 2025
v15	18 ottobre 2023	21 febbraio 2024	25 settembre 2024	Upgrade dalla v15 alla v16
v14.1	9 agosto 2023	18 ottobre 2023	5 giugno 2024
v14	7 giugno 2023	18 ottobre 2023	5 giugno 2024	Eseguire l'upgrade dalla v14 alla v15

Visualizza le versioni in uso nel progetto

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

1. Apri la sezione API e servizi nella console Google Cloud.
2. Fai clic su API Google Ads nella tabella.
3. Nella scheda secondaria METRICHE, le richieste recenti dovrebbero essere rappresentate in ciascun 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 di metodo, ad esempio google.ads.googleads.v17.services.GoogleAdsService.Mutate.
4. (Facoltativo) Scegli l'intervallo di tempo che vuoi visualizzare per le richieste.

Differenze tra ritiro e ritiro

Termine	Ritiro	Tramonto
Definizione	La versione deprecata è una versione non quella più recente. Una volta rilasciata una nuova versione, tutte le versioni precedenti verranno contrassegnate come deprecate.	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 deprecate fino al ritiro, ma i riferimenti a queste versioni vengono rimossi per indicare che non sono più l'ultima versione. Ti invitiamo a eseguire l'upgrade alla versione più recente 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 alla versione più recente, utilizzando la guida all'upgrade.
Tempistiche	In media, rilasciamo una nuova versione ogni 3-4 mesi, quindi la versione specificata verrà deprecata dopo circa 3-4 mesi.	Abbiamo intenzione di ritirare una versione un anno dopo il suo rilascio.
API	Gli endpoint API per le versioni deprecate funzionano ancora come di consueto. Puoi accedere agli endpoint API utilizzando le nostre librerie client, REST e così via; tuttavia, le nuove funzionalità non vengono aggiunte alle versioni deprecate.	Gli endpoint API per le versioni ritirate smetteranno di funzionare dopo le date di ritiro. L'API Google Ads genera un errore se tenti di accedere agli endpoint API delle versioni ritirate.
Librerie client	Per fornire librerie client compatte, non includeremo più versioni API deprecate in una nuova versione della libreria client dopo la data di ritiro. Questo ti consente di 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 deprecate.	Le versioni ritirate non sono più supportate dopo la data di ritiro.

Versioni della libreria client supportate

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

Ritiri di funzionalità

Monitora regolarmente il blog per gli sviluppatori Google Ads per essere tra i primi a conoscere i prossimi ritiri delle funzionalità.

La seguente tabella elenca i ritiri specifici di funzionalità attualmente 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
Strategia di offerta basata sulle commissioni	L'API Google Ads non supporta più la creazione di campagne per hotel con la strategia di offerta COMMISSION .	30 aprile 2024	Le richieste di creazione di nuove campagne per hotel o di applicazione della strategia di offerta COMMISSION alle campagne esistenti comporteranno un errore BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. Le campagne esistenti con la strategia di offerta COMMISSION continueranno a essere pubblicate fino al 31 ottobre 2024. Dopo questo giorno, la pubblicazione delle campagne verrà interrotta fino all'aggiornamento della strategia di offerta.