Esegui la migrazione a una nuova versione

Vengono rilasciate regolarmente nuove versioni dell'API Campaign Manager 360. Man mano che vengono rilasciate nuove versioni, quelle precedenti vengono ritirate e infine deprecate. Quando una versione viene ritirata, tutte le richieste relative a quella versione iniziano a restituire errori.

Se la versione che utilizzi è ritirata, devi eseguire l'upgrade il prima possibile per evitare interruzioni del servizio.

Passaggio 1: determina la versione in uso

Puoi determinare la versione dell'API in uso seguendo le istruzioni riportate di seguito. Nella maggior parte dei casi, accederai all'API utilizzando una delle nostre librerie client specifiche per i vari linguaggi o un'integrazione ufficiale.

Nuovo editor di Apps Script

Le informazioni sulla versione di Apps Script sono esposte nella finestra di dialogo dei servizi avanzati:

1. Nell'editor Apps Script, fai clic su Aggiungi un servizio .
2. Individua l'API Campaign Manager 360 nell'elenco dei servizi disponibili.
3. Il valore selezionato nel menu a discesa della versione è la versione dell'API Campaign Manager 360 in uso.

Editor precedente di Apps Script

Le informazioni sulla versione di Apps Script sono esposte nella finestra di dialogo dei servizi avanzati:

1. Nell'editor di Apps Script, vai a Risorse > Servizi Google avanzati.
2. Individua l'API Campaign Manager 360 nell'elenco dei servizi disponibili.
3. 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 esposte nei seguenti punti:

1. Incluso nel nome del pacchetto NuGet e nello spazio dei nomi del servizio.

   Google.Apis.Dfareporting.v3_4

2. Esposto 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 esposte nei seguenti posizioni:

1. Specificato in artifactId di Maven.

   <dependency> <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-dfareporting</artifactId>
   <version>v3.4-rev1-1.21.0</version>
   </dependency>

2. Incluso nel nome file JAR.

   google-api-services-dfareporting-v3.4-rev1-1.21.0.jar

3. Esposto 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 vengono 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 è sottoposta al controllo delle versioni. La versione API da utilizzare è specificata come argomento del generatore di rilevamento:

discovery.build('dfareporting', 'v3.4', http=http)

Ruby

Le versioni della libreria client delle API di Google per Ruby precedenti alla 0.9 non sono versionate. La versione dell'API da utilizzare è specificata come argomento del costruttore del servizio:

service = Google::APIClient::Service.new("dfareporting", "v3.4", { :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.DfareportingV3_4

Passaggio 2: determina lo stato della tua versione

Controlla il programma di 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 fine del supporto:

• Se non sono presenti date, la tua versione è completamente supportata.
• Se sono presenti date, la tua versione è deprecata e verrà ritirata alla data specificata.

Se la tua versione è ritirata o è stata ritirata, 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 versioni 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 alcune librerie client potrebbero fornire una singola build che funziona con qualsiasi versione dell'API, mentre altre avranno build separate per ogni versione. L'elenco seguente 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 un determinato script:

1. Nell'editor Apps Script, fai clic su Aggiungi un servizio .
2. Individua l'API Campaign Manager 360 nell'elenco dei servizi disponibili.
3. Modifica la versione dell'API Campaign Manager 360 utilizzando il menu a discesa della versione.
4. Fai clic su Aggiungi per salvare le modifiche.

Editor precedente 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 un determinato script:

1. Nell'editor di Apps Script, vai a Risorse > Servizi Google avanzati.
2. Individua l'API Campaign Manager 360 nell'elenco dei servizi disponibili.
3. Modifica la versione dell'API Campaign Manager 360 utilizzando il menu a discesa della versione.
4. 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'aggiornamento 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'aggiornamento 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'aggiornamento 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 dell'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 di versione passata come argomento al generatore di discovery:

discovery.build('dfareporting', 'v3.4', http=http)

Per istruzioni di installazione dettagliate o opzioni di download alternative, consulta la documentazione della libreria client.

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 di versione passata come argomento al costruttore del servizio:

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)

La libreria client delle API di Google per Ruby v0.9+ fornisce build separate per ogni versione dell'API Campaign Manager 360, distribuite tramite RubyGems. Esegui l'aggiornamento 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.

REST

Se chiami l'API direttamente utilizzando HTTPS, aggiorna l'endpoint per le tue richieste in modo che utilizzino 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/...

A:

https://dfareporting.googleapis.com/dfareporting/v5/...

Passaggio 4: differenze tra le versioni dell'indirizzo

Le nuove versioni dell'API sono progettate per essere compatibili con le versioni precedenti, ove possibile. Tuttavia, alcuni aggiornamenti potrebbero includere modifiche irreversibili che richiedono la modifica del codice. Queste modifiche sono descritte in dettaglio nelle note di rilascio.

Durante la migrazione, esamina le note di rilascio di ogni versione tra quella attuale e quella a cui stai eseguendo l'upgrade. Presta particolare attenzione alle seguenti sezioni:

• Nuove funzionalità: funzionalità appena aggiunte. Questi non richiedono modifiche al codice per la migrazione.
• Ritiri: funzionalità rimossa dall'API. La funzionalità di sostituzione è indicata quando disponibile.
• Problemi noti: modifiche alla funzionalità esistente, ad esempio campi o metodi rinominati o logica di convalida modificata.

Se la tua applicazione utilizza funzionalità elencate nelle sezioni Ritiri o Problemi noti, dovrai aggiornare il codice per risolvere questi problemi.

Seguire le novità

Monitora regolarmente il blog per sviluppatori di Google Ads per essere il primo a scoprire gli aggiornamenti, i ritiri e le chiusure delle API.