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 alla fine disattivate. Quando una versione viene ritirata, tutte le richieste relative a quella versione iniziano a restituire errori.

Se una versione dell'API che utilizzi è deprecata, dovrai eseguire la migrazione a una versione più recente prima della data di ritiro pianificata. Questa guida fornisce dettagli su come determinare se la versione dell'API che stai utilizzando è deprecata e fornisce i passaggi di migrazione consigliati.

Passaggio 1: determina quale versione stai utilizzando

Se gestisci un'applicazione che sospetti possa utilizzare una versione ritirata dell'API Campaign Manager 360, devi prima verificare quale versione specifica stai utilizzando. Nella maggior parte dei casi, accederai all'API tramite una delle nostre librerie client specifiche per i vari linguaggi o un'integrazione ufficiale. Di seguito sono riportate le istruzioni per trovare la versione dell'API in uso da queste librerie client e integrazioni:

Nuovo editor 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, 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 attualmente 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 attualmente in uso.

C#

Le informazioni sulla versione della libreria client dell'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 tramite 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 punti:

  1. Specificato nell'attributo 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 del file JAR. 
    google-api-services-dfareporting-v3.4-rev1-1.21.0.jar
  3. Esposto tramite 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 tramite 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 è versione. La versione dell'API da utilizzare viene specificata come argomento per lo Strumento per la creazione di annunci: 

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 viene 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

Prendi nota della versione in uso, perché ti serviranno queste informazioni in seguito.

Passaggio 2: determina lo stato della tua versione

Il Piano di ritiro elenca lo stato di ogni versione attualmente supportata. Individua la tua versione in questo elenco e determina il relativo stato nel seguente modo:

  1. Se non sono presenti date nelle colonne Data ritiro e Data ritiro, significa che stai utilizzando una versione completamente supportata.
  2. Se sono elencate delle date, la versione che stai utilizzando è attualmente deprecata e verrà ritirata nella data specificata.
  3. Se la tua versione non è elencata, significa che è già stata ritirata e non è più supportata.

Se rientri nel caso 2 o 3 riportato sopra, dovrai eseguire la migrazione a una versione più recente per evitare un'interruzione del servizio. Ti consigliamo di eseguire la migrazione alla versione più recente, indicata nella parte superiore della tabella del programma di ritiro (esclusi i release beta). In questo modo avrai a disposizione il massimo tempo tra un upgrade e l'altro.

Passaggio 3: esegui l'upgrade delle versioni

Se hai stabilito che devi eseguire la migrazione, il passaggio successivo consiste nell'aggiornare l'integrazione o nell'ottenere una build aggiornata della libreria client che preferisci. Tieni presente che, mentre alcune librerie client potrebbero fornire una sola build che funziona con qualsiasi versione dell'API, altre avranno build separate per ogni versione. L'elenco seguente fornisce informazioni generali sull'upgrade per le librerie e le integrazioni client 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 in base allo script. Per modificare la versione utilizzata da un determinato script:

  1. Nell'editor di 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 in uso tramite il menu a discesa delle versioni.
  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 in base allo 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 in uso tramite il menu a discesa delle versioni.
  4. Fai clic su OK per salvare le modifiche.

C#

La libreria client dell'API di Google per .NET fornisce build separate per ogni versione dell'API Campaign Manager 360, distribuite tramite NuGet.

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

Java

La libreria client dell'API di Google per Java fornisce build separate per ogni versione dell'API Campaign Manager 360, distribuita tramite Maven.

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

PHP

La libreria client delle API Google per PHP fornisce build separate per ogni versione dell'API Campaign Manager 360, distribuita tramite Packagist.

Per istruzioni dettagliate sull'installazione 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. Aggiorna semplicemente la stringa di versione passata come argomento al generatore di annunci discovery: 

discovery.build('dfareporting', 'v3.4', http=http)
 Per istruzioni dettagliate sull'installazione o opzioni di download alternative, consulta la documentazione della libreria client.

Ruby

La versione 0.8 e precedenti della libreria client delle API di Google per Ruby supporta tutte le versioni dell'API Campaign Manager 360. Aggiorna semplicemente 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 versione 0.9 e successive della libreria client dell'API di Google per Ruby fornisce build separate per ogni versione dell'API Campaign Manager 360, distribuita tramite RubyGems. Per istruzioni dettagliate sull'installazione o opzioni di download alternative, consulta la documentazione della libreria client.

Passaggio 4: gestisci le differenze tra le versioni

Ci impegniamo a rendere le nostre nuove release compatibili con le versioni precedenti, il che significa che la migrazione tra le versioni dell'API non richiederà modifiche al codice. Quando non è possibile, annunciamo le modifiche che richiedono un intervento da parte degli sviluppatori (note anche come modifiche che comportano interruzioni) nelle nostre note di rilascio.

A questo punto, devi esaminare le nostre note di rilascio, iniziando dalla versione successiva a quella da cui hai iniziato (che hai annotato in una sezione precedente) e continuando fino alla versione a cui stai eseguendo l'upgrade, inclusa. Le sezioni delle note di rilascio devono essere interpretate come segue:

  • Nuove funzionalità: funzionalità appena aggiunte.
  • Ritiro: funzionalità rimosse dall'API. Se disponibile, le funzionalità sostitutive verranno trattate in questa sezione.
  • Problemi noti: modifiche che non sono aggiunte o rimozioni. Ad esempio, questa sezione potrebbe riguardare campi o metodi che sono stati rinominati o la logica di convalida che è cambiata.

Le funzionalità in Nuove funzionalità non richiedono modifiche al codice e possono essere ignorate per il momento. Non esitare a tornare in questa sezione in un secondo momento se vuoi provare qualcosa che abbiamo aggiunto.

Se invece riscontri modifiche nelle sezioni Ritiro o Problemi noti, potresti dover intervenire. Devi cercare nel codice per determinare se le funzionalità rimosse o modificate sono utilizzate dalla tua applicazione. In questo caso, dovrai aggiornare il codice per gestire queste modifiche

Seguire le novità

Come accennato in precedenza, le release e i ritiri dell'API Campaign Manager 360 avvengono regolarmente. Gli aggiornamenti relativi a nuove release, ritiri e ritiri dal mercato vengono pubblicati sui seguenti canali:

Ti consigliamo di iscriverti a uno o più di questi canali per rimanere al passo con le ultime notizie sull'API.