Eseguire la migrazione da v2 a v3

Ultimo aggiornamento: 31/10/2023

Esegui la migrazione della tua applicazione

La migrazione dalla v2 alla v3 richiede l'aggiornamento degli URL degli endpoint in modo che chiamino la v3 e l'aggiornamento dell'applicazione per tenere conto delle modifiche che provocano un errore.

Aggiorna le chiamate API da v2 a v3

Per usare la versione 3 anziché la v2, devi aggiornare le richieste in modo da utilizzare i nuovi endpoint v3.

Ad esempio, per chiamare il metodo advertisers.get con v2, devi utilizzare il seguente URL:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

Per la versione 3, aggiorna l'URL come segue:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

Se usi una libreria client per effettuare richieste all'API, utilizza la versione più recente della libreria client e aggiorna la configurazione in modo da utilizzare la versione 3.

Apporta le modifiche desiderate

Stiamo introducendo una serie di modifiche che provocano errori nella versione 3. Consulta le seguenti istruzioni e apporta le modifiche necessarie relative all'utilizzo esistente dell'API Display & Video 360.

Aggiorna le chiamate per il recupero delle risorse di YouTube e il relativo targeting

• Le risorse YoutubeAdGroup e YoutubeAdGroupAd sono state sostituite dalle risorse AdGroup e AdGroupAd. Queste nuove risorse forniscono informazioni quasi identiche a quelle della v2, ma possono utilizzare nomi di campo o tipi di enum aggiornati. Nell'integrazione, sostituisci i tuoi utilizzi delle risorse YoutubeAdGroup o YoutubeAdGroupAd con le risorse AdGroup e AdGroupAd e aggiorna le chiamate ai seguenti servizi v2 al servizio v3 corrispondente:
  • Da advertisers.youtubeAdGroupAds a advertisers.adGroupAds
  • Da advertisers.youtubeAdGroups a advertisers.adGroups
  • Da advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions a advertisers.adGroups.targetingTypes.assignedTargetingOptions
• I riferimenti agli oggetti YoutubeAndPartnersBiddingStrategy sono stati spostati in un nuovo campo youtubeAndPartnersBid all'interno dell'oggetto generale BiddingStrategy. Il campo biddingStrategy è stato rimosso dall'oggetto YoutubeAndPartnersSettings. Aggiorna l'integrazione per recuperare la strategia di offerta per gli elementi pubblicitari o i gruppi di annunci di YouTube dall'oggetto BiddingStrategy nel campo bidStrategy nella risorsa LineItem o AdGroup.
• Il campo thirdPartyMeasurementSettings è stato rinominato thirdPartyMeasurementConfigs nell'oggetto YoutubeAndPartnersSettings e l'oggetto YoutubeAndPartnersThirdPartyMeasurementSettings è stato rinominato in ThirdPartyMeasurementConfigs. Aggiorna l'integrazione per recuperare le informazioni di configurazione della misurazione di terze parti utilizzando il nuovo campo e il nuovo oggetto.

Includi le configurazioni di fatturazione richieste durante la creazione degli inserzionisti

Ora billingConfig è un campo obbligatorio nella risorsa Advertiser. Aggiorna le richieste advertisers.create per verificare che questo campo sia impostato. È possibile recuperare i dati di fatturazione predefiniti per il partner principale tramite il nuovo campo Partner risorsa billingConfig.

Utilizza un nuovo campo per controllare il targeting ottimizzato

Un nuovo campo booleano enableOptimizedTargeting ha sostituito il campo targetingExpansionLevel nell'oggetto TargetingExpansionConfig.

Aggiorna l'integrazione dell'ordine di inserzione per utilizzare il nuovo campo KPI

Un nuovo campo kpi ha sostituito il campo performanceGoal nella risorsa InsertionOrder. Questo nuovo campo utilizza un oggetto Kpi al posto dell'oggetto PerformanceGoal e nuovi campi ed enumerazioni.

Rimuovi i riferimenti a servizi e campi deprecati

Nella versione 3 sono state rimosse varie entità per allinearle ai precedenti ritiri di funzionalità:

• Il servizio advertisers.manualTriggers è stato rimosso perché i trigger manuali sono stati deprecati.
• Il campo billableOutcome è stato rimosso dalla risorsa InsertionOrder poiché l'acquisto basato sui risultati è stato ritirato.

Ulteriori modifiche

Oltre alle modifiche che provocano un errore elencate sopra, la versione 3 introduce anche nuove funzionalità.

Le funzionalità aggiunte alla versione 3 dopo il lancio iniziale sono disponibili nelle nostre note di rilascio.

Gestione dell'elenco di località di prossimità

Nella versione 3 puoi gestire completamente gli elenchi di località di prossimità, in modo da utilizzare il servizio advertisers.locationLists.assignedLocations per creare ed eliminare le località assegnate alle risorse TARGETING_LOCATION_TYPE_PROXIMITY LocationList. Le località sono identificate utilizzando l'ID delle risorse TARGETING_TYPE_POI TargetingOption. Puoi recuperarli utilizzando targetingTypes.targetingOptions.search.

Possibilità di creare algoritmi di offerte personalizzate basati su regole

Nella versione 3 puoi creare e recuperare algoritmi di offerte personalizzate basati su regole utilizzando i servizi customBiddingAlgorithms, media e customBiddingAlgorithms.rules.

Questa funzionalità è in versione beta ed è disponibile solo per i partner nella lista consentita. Se il tuo partner non è incluso nella lista consentita, la tua richiesta restituirà un errore.