Ritiro e ritiro

Con il rilascio di una nuova versione, un server viene assegnata una data di ritiro, oltre la quale tale versione non sarà più disponibili. 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. Le versioni minori: 10 mesi.
  • Devi eseguire al massimo due upgrade all'anno e non disponi di eseguire l'upgrade in ordine sequenziale rigoroso; ad esempio, puoi eseguire l'upgrade dalla versione (N) alla versione (N+2).
  • La sovrapposizione tra la data di rilascio di tutte le librerie client per l'account e la versione da ritirare è di almeno 20 settimane.

Le nostre librerie client supportano tutte le versioni disponibili di , quindi puoi eseguire gradualmente l'upgrade specificando le diverse versioni i servizi di machine learning.

Orario

La seguente tabella elenca le date di ritiro e ritiro specifiche di ciascuno e le date di uscita previste per le versioni future. Me ti consigliamo di eseguire l'upgrade alla versione più recente non appena possibile .

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 7 agosto 2024 Set/Ott 2024 Maggio 2025
v17 June 5, 2024 Set/ottobre 2024 Maggio 2025
v16.1 24 aprile 2024 June 5, 2024 Gennaio 2025 Eseguire l'upgrade dalla v16 alla v17
v16 21 febbraio 2024 June 5, 2024 Gennaio 2025 Eseguire l'upgrade dalla v16 alla v17
v15 18 ottobre 2023 21 febbraio 2024 25 settembre 2024 Upgrade dalla v15 alla v16

Visualizza le versioni in uso nel progetto

Puoi visualizzare un elenco di metodi e servizi che il tuo progetto ha recentemente chiamato utilizzando la console Google Cloud:

  1. Apri il menu API e Services nella console Google Cloud.
  2. Fai clic su API Google Ads nella tabella.
  3. Nella scheda METRICHE le richieste recenti dovrebbero essere rappresentate in base ai in ogni grafico. Puoi vedere a quali metodi hai inviato richieste nel Tabella Methods. Il nome del metodo include una versione dell'API Google Ads, un servizio e un nome di metodo, come 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

TermineRitiroTramonto
Definizione La versione deprecata è una versione non quella più recente. Quando viene rilasciata una nuova versione, tutte le versioni precedenti vengono contrassegnate ritirato. La versione ritirata non può più essere utilizzata. Richieste inviate a questo indirizzo avrà esito negativo nella data di ritiro o in una data successiva.
Implicazione Puoi continuare a utilizzare le versioni obsolete fino al ritiro. ma i riferimenti delle versioni deprecate vengono rimossi per mostrare che non sono più l'ultima versione.

Ti invitiamo a eseguire l'upgrade alla versione più recente il prima possibile per usufruiscono di nuove funzionalità.

Devi eseguire l'upgrade dalle versioni ritirate immediatamente in per utilizzare l'API Google Ads.

Ti consigliamo vivamente di eseguire l'upgrade alla versione più recente dell'aggiornamento, utilizzando la guida all'upgrade.

Tempistiche In media rilasciamo una nuova versione ogni 3-4 mesi, quindi le 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 continuano a funzionare come al solito.

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 smettono di funzionare dopo il date di ritiro. L'API Google Ads genera un errore se provi ad accedere al Endpoint API delle versioni ritirate.
Librerie client Per fornire le librerie client compatte, interromperemo incluse versioni dell'API deprecate in una nuova versione della libreria client dopo la data di ritiro. Ciò consente di risparmiare spazio durante l'incorporamento e le librerie client nei tuoi progetti. Le librerie client non supportano più le versioni dell'API ritirate in per 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 il ritiro data.

Versioni della libreria client supportate

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

Java

Libreria client per Java
v17
32.0.0 Min: Max: -
v16
30.0.0 Min: Max: -
v15 Min: 28.0.0
Max: 32.0.0

C#

Libreria client per .NET
v17
20.1.0 Min: Max: -
v16
18.1.0 Min: Max: -
v15 Min: 17.1.0
Max: 20.1.0

PHP

Libreria client per PHP
v17
23.1.0 Min: Max: -
v16
22.1.0 Min: Max: -
v15 Min: 21.1.0
Max: 23.1.0

Python

Libreria client per Python
v17
24.1.0 Min: Max: -
v16
23.1.0 Min: Max: -
v15
22.1.0 Min: Max: -

Ruby

Libreria client per Ruby
v17
29.0.0 Min: Max: -
v16
27.0.0 Min: Max: -
v15
25.0.0 Min: Max: -

Perl

Libreria client per Perl
v17
23.0.0 Min: Max: -
v16
21.0.0 Min: Max: -
v15
19.0.0 Min: Max: -

Ritiri di funzionalità

Monitora regolarmente il blog per gli sviluppatori Google Ads di essere tra i primi a scoprire l'imminente ritiro di funzionalità.

La tabella riportata di seguito elenca le funzionalità specifiche ritirate attualmente previsti per l'API Google Ads. Sono disponibili ulteriori dettagli relativi a 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 COMMISSION strategia di offerta . 30 aprile 2024 Richieste di creazione di nuove campagne per hotel o di applicazione del COMMISSION strategia di offerta per le campagne esistenti comporterà un BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED . Campagne esistenti con l'offerta COMMISSION continuerà a essere eseguita fino al 31 ottobre 2024. Dopo questo giorno la pubblicazione delle campagne verrà interrotta fino a quando la relativa strategia di offerta non verrà aggiornata.