Vengono rilasciate regolarmente nuove versioni dell'API Campaign Manager 360. Con il rilascio di nuove versioni, le versioni precedenti vengono ritirate e infine rese obsolete. Quando una versione viene ritirata, tutte le richieste relative a quella versione iniziano a restituire errori.
Se la versione che utilizzi è stata ritirata, devi eseguire l'upgrade il prima possibile per evitare interruzioni del servizio.
Passaggio 1: determina la versione che utilizzi
Puoi determinare la versione dell'API che utilizzi seguendo queste istruzioni. Nella maggior parte dei casi, accederai all'API utilizzando una delle nostre librerie client specifiche per i linguaggi o un'integrazione ufficiale.
Nuovo editor di Apps Script
Le informazioni sulla versione di Apps Script sono disponibili nella finestra di dialogo dei servizi avanzati:
- Nell'editor di Apps Script, fai clic su Aggiungi un servizio .
- Individua l'API Campaign Manager 360 nell'elenco dei servizi disponibili.
- Il valore selezionato nel menu a discesa della versione è la versione dell'API Campaign Manager 360 in uso.
Editor legacy di Apps Script
Le informazioni sulla versione di Apps Script sono disponibili nella finestra di dialogo dei servizi avanzati:
- Nell'editor di script di Apps Script, vai a Risorse > Servizi avanzati di Google.
- Individua l'API Campaign Manager 360 nell'elenco dei servizi disponibili.
- Il valore selezionato nel menu a discesa della versione è la versione dell'API Campaign Manager 360 in uso.
C#
Le informazioni sulla versione della libreria client delle API di Google per .NET sono disponibili nei seguenti punti:
- Sono incluse nel nome del pacchetto NuGet e nello spazio dei nomi del servizio.
Google.Apis.Dfareporting.v5
- Sono esposte utilizzando una proprietà pubblica di
DfareportingService.Console.WriteLine(DfareportingService.Version);
Java
Le informazioni sulla versione della libreria client delle API di Google per Java sono disponibili nei seguenti punti:
- Sono specificate nell'artifactId Maven.
<dependency> <groupId>com.google.apis</groupId> <artifactId>google-api-services-dfareporting</artifactId> <version>v5-rev20260213-2.0.0</version> </dependency>
- Sono incluse nel nome file JAR.
google-api-services-dfareporting-v5-rev20260213-2.0.0.jar
- Sono esposte utilizzando una proprietà pubblica di
Dfareporting.System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);
PHP
Le informazioni sulla versione della libreria client delle API di Google per PHP sono esposte utilizzando una proprietà pubblica di Google_Service_Dfareporting:
$service = new Google_Service_Dfareporting($client) print $service->version;
Python
La libreria client delle API di Google per Python (v1/v2) non è versionata. La versione dell'API da utilizzare viene specificata come argomento del builder di rilevamento:
discovery.build('dfareporting', 'v5', http=http)
Ruby
Le versioni della libreria client delle API di Google per Ruby < 0.9 non sono versionate. La versione dell'API da utilizzare viene specificata come argomento del costruttore del servizio:
service = Google::APIClient::Service.new("dfareporting", "v5", { :application_name => "My application", :application_version => '1.0.0', :authorization => authorization } )
Per le versioni della libreria client delle API di Google per Ruby >= 0.9, la versione è esposta nello spazio dei nomi del servizio:
Google.Apis.DfareportingV5
Passaggio 2: determina lo stato della tua versione
Controlla la pianificazione del ritiro per determinare lo stato della tua versione. Se la tua versione non è elencata, è stata ritirata e non è più supportata.
Se la tua versione è elencata, controlla le colonne Data di ritiro e Data di obsolescenza:
- Se non sono presenti date, la tua versione è completamente supportata.
- Se sono presenti date, la tua versione è stata ritirata e verrà resa obsoleta alla data specificata.
Se la tua versione è stata ritirata o è obsoleta, devi eseguire la migrazione a una versione più recente per evitare interruzioni del servizio. Ti consigliamo di eseguire la migrazione alla versione più recente mostrata nella pianificazione (escluse le release beta) per massimizzare il tempo tra gli upgrade.
Passaggio 3: esegui l'upgrade delle versioni
Per eseguire la migrazione a una versione più recente dell'API, devi aggiornare l'integrazione o ottenere una build aggiornata della libreria client che preferisci. Tieni presente che, mentre alcune librerie client potrebbero fornire una singola build che funziona con qualsiasi versione dell'API, altre avranno build separate per ogni versione. Il seguente elenco fornisce informazioni generali sull'upgrade per le librerie client e le integrazioni più utilizzate.
Nuovo editor di Apps Script
Google Apps Script supporta tutte le versioni dell'API Campaign Manager 360 e ti consente di selezionare la versione da utilizzare per ogni script. Per modificare la versione utilizzata da uno script specifico:
- Nell'editor di Apps Script, fai clic su Aggiungi un servizio .
- Individua l'API Campaign Manager 360 nell'elenco dei servizi disponibili.
- Modifica la versione dell'API Campaign Manager 360 utilizzando il menu a discesa della versione.
- Fai clic su Aggiungi per salvare le modifiche.
Editor legacy di Apps Script
Google Apps Script supporta tutte le versioni dell'API Campaign Manager 360 e ti consente di selezionare la versione da utilizzare per ogni script. Per modificare la versione utilizzata da uno script specifico:
- Nell'editor di script di Apps Script, vai a Risorse > Servizi avanzati di Google.
- Individua l'API Campaign Manager 360 nell'elenco dei servizi disponibili.
- Modifica la versione dell'API Campaign Manager 360 utilizzando il menu a discesa della versione.
- Fai clic su OK per salvare le modifiche.
C#
La libreria client delle API di Google per .NET fornisce build separate per ogni versione dell'API Campaign Manager 360, distribuite tramite NuGet. Esegui l'upgrade a una versione della libreria client corrispondente alla versione dell'API che vuoi utilizzare.
Per istruzioni di installazione dettagliate o opzioni di download alternative, consulta la documentazione della libreria client.
Java
La libreria client delle API di Google per Java fornisce build separate per ogni versione dell'API Campaign Manager 360, distribuite tramite Maven. Esegui l'upgrade a una versione della libreria client corrispondente alla versione dell'API che vuoi utilizzare.
Per istruzioni di installazione dettagliate o opzioni di download alternative, consulta la documentazione della libreria client.
PHP
La libreria client delle API di Google per PHP fornisce build separate per ogni versione dell'API Campaign Manager 360, distribuite tramite Packagist. Esegui l'upgrade a una versione della libreria client corrispondente alla versione dell'API che vuoi utilizzare.
Per istruzioni di installazione dettagliate o opzioni di download alternative, consulta la documentazione della libreria client.
Python
Ogni build della libreria client delle API di Google per Python (v1/v2) supporta tutte le versioni dell'API Campaign Manager 360. Per eseguire la migrazione a una nuova versione dell'API Campaign Manager 360, aggiorna la stringa della versione passata come argomento al builder di rilevamento:
discovery.build('dfareporting', 'v5', http=http)
Ruby
La libreria client delle API di Google per Ruby v0.8 e versioni precedenti supporta tutte le versioni dell'API Campaign Manager 360. Per eseguire la migrazione a una nuova versione dell'API Campaign Manager 360, aggiorna la stringa della versione passata come argomento al costruttore del servizio:
service = Google::APIClient::Service.new("dfareporting", "v5", { :application_name => "My application", :application_version => '1.0.0', :authorization => authorization } )
REST
Se chiami l'API direttamente utilizzando HTTPS, aggiorna l'endpoint delle richieste per utilizzare il nuovo numero di versione dell'API.
Ad esempio, quando esegui la migrazione da v4 a v5, devi modificare l'URL di base da:
https://dfareporting.googleapis.com/dfareporting/v4/...
https://dfareporting.googleapis.com/dfareporting/v5/...
Passaggio 4: risolvi le differenze tra le versioni
Le nuove versioni dell'API sono progettate per essere retrocompatibili, ove possibile. Tuttavia, alcuni aggiornamenti potrebbero includere modifiche che causano interruzioni e che richiedono la modifica del codice. Queste modifiche sono descritte in dettaglio nelle note di rilascio.
Durante la migrazione, esamina le note di rilascio per ogni versione tra la versione attuale e quella a cui stai eseguendo l'upgrade. Presta particolare attenzione alle seguenti sezioni:
- Nuove funzionalità: funzionalità appena aggiunte. Non richiedono modifiche al codice per la migrazione.
- Ritiro: funzionalità rimosse dall'API. Se disponibili, vengono indicate le funzionalità sostitutive.
- Problemi noti: modifiche alle funzionalità esistenti, ad esempio campi o metodi rinominati o logica di convalida modificata.
Se la tua applicazione utilizza funzionalità elencate nelle sezioni Ritiro o Problemi noti, dovrai aggiornare il codice per risolvere queste modifiche.
Seguire le novità
Monitora regolarmente il blog per sviluppatori di Google Ads per essere il primo a conoscere le release, i ritiri e le obsolescenze delle API.