Con il rilascio di una nuova versione, a una versione deprecata viene assegnata una data di ritiro, dopo la quale la versione non sarà più disponibile. Ecco alcune linee guida da tenere a mente:
- Sono disponibili al massimo tre versioni principali contemporaneamente.
- Le versioni principali hanno una durata di circa 12 mesi, mentre le versioni secondarie hanno una durata di circa 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 direttamente dalla versione (N) alla versione (N+2).
- La sovrapposizione tra la data in cui tutte le librerie client vengono rilasciate 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 versioni diverse dei servizi utilizzati.
Orario
Nella tabella che segue sono elencate le date di ritiro e ritiro specifiche per ogni versione disponibile, nonché le date di rilascio previste per le versioni future. Ti invitiamo a eseguire l'upgrade alla versione più recente il prima possibile dopo il rilascio.
| Versione API | Data di uscita | Data di deprecazione | Data di ritiro | Guida all'upgrade |
|---|---|---|---|---|
| v18 | Set/ottobre 2024 | Gen/feb 2025 | Settembre 2025 | |
| v17.1 | Luglio/agosto 2024 | Set/ottobre 2024 | Maggio 2025 | |
| v17 | Maggio/Giugno 2024 | Set/ottobre 2024 | Maggio 2025 | |
| v16.1 | 24 aprile 2024 | Maggio/Giugno 2024 | Gennaio 2025 | |
| v16 | 21 febbraio 2024 | Maggio/Giugno 2024 | Gennaio 2025 | |
| v15 | 18 ottobre 2023 | 21 febbraio 2024 | 25 settembre 2024 | Eseguire l'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 utilizzate dal progetto
Puoi visualizzare un elenco dei metodi e dei 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 dovrebbero essere visualizzate le richieste recenti tracciate su 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 del metodo, ad esempio
google.ads.googleads.v16.services.GoogleAdsService.Mutate. - (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 la 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 delle versioni deprecate vengono rimossi per mostrare
che non sono più la versione più recente.
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 immediatamente l'upgrade dalle versioni ritirate.
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 in questione verrà deprecata dopo circa 3-4 mesi. | Il nostro obiettivo è ritirare una versione un anno dopo la sua uscita. |
| API | Gli endpoint API per le versioni deprecate funzionano come di consueto.
Puoi accedere agli endpoint API utilizzando le nostre librerie client, REST e così via. Tuttavia, alle versioni deprecate non vengono aggiunte nuove funzionalità. |
Gli endpoint API per le versioni di ritiro 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 | Al fine di fornire librerie client compatte, non includeremo più versioni deprecate delle API in una nuova versione delle librerie 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 delle librerie client dopo le date di ritiro. |
| Assistenza | Forniamo assistenza regolare per le versioni deprecate. | Le versioni di ritiro non sono più supportate dopo la data di ritiro. |
Versioni di libreria client supportate
La tabella mostra quali librerie client funzionano con le diverse versioni dell'API.
Java
API Google Ads |
Libreria client per Java |
v16 |
Min: 30.0.0Max: |
v15 |
Min: 28.0.0Max: |
v14 |
Min: 26.0.0Max: 30.0.0
|
C#
API Google Ads |
Libreria client per .NET |
v16 |
Min: 18.1.0Max: |
v15 |
Min: 17.1.0Max: |
v14 |
Min: 16.1.0Max: 19.0.1 |
PHP
API Google Ads |
Libreria client per PHP |
v16 |
Min: 22.1.0Max: |
v15 |
Min: 21.1.0Max: |
Python
API Google Ads |
Libreria client per Python |
v16 |
Min: 23.1.0Max: |
v15 |
Min: 22.1.0Max: |
Ruby
API Google Ads |
Libreria client per Ruby |
v16 |
Min: 27.0.0Max: |
v15 |
Min: 25.0.0Max: |
v14 |
Min: 23.0.0Max: |
Perl
API Google Ads |
Libreria client per Perl |
v16 |
Min: 21.0.0Max: |
v15 |
Min: 19.0.0Max: |
v14 |
Min: 17.0.0Max: 21.0.0 |
Ritiri di funzionalità
Monitora regolarmente il blog per gli sviluppatori di Google Ads per essere tra i primi a venire a conoscenza del ritiro di funzionalità imminenti.
La tabella riportata di seguito elenca il ritiro di funzionalità specifiche attualmente pianificate per l'API Google Ads. Puoi trovare ulteriori dettagli su ogni ritiro 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 per creare nuove campagne per hotel o applicare la strategia di offerta COMMISSION
alle campagne esistenti genereranno 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. Al termine di questo giorno, la pubblicazione delle campagne verrà interrotta finché la strategia di offerta non verrà aggiornata.
|