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
eYoutubeAdGroupAd
sono state sostituite dalle risorseAdGroup
eAdGroupAd
. 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 risorseYoutubeAdGroup
oYoutubeAdGroupAd
con le risorseAdGroup
eAdGroupAd
e aggiorna le chiamate ai seguenti servizi v2 al servizio v3 corrispondente:- Da
advertisers.youtubeAdGroupAds
aadvertisers.adGroupAds
- Da
advertisers.youtubeAdGroups
aadvertisers.adGroups
- Da
advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions
aadvertisers.adGroups.targetingTypes.assignedTargetingOptions
- Da
- I riferimenti agli oggetti
YoutubeAndPartnersBiddingStrategy
sono stati spostati in un nuovo campoyoutubeAndPartnersBid
all'interno dell'oggetto generaleBiddingStrategy
. Il campobiddingStrategy
è stato rimosso dall'oggettoYoutubeAndPartnersSettings
. Aggiorna l'integrazione per recuperare la strategia di offerta per gli elementi pubblicitari o i gruppi di annunci di YouTube dall'oggettoBiddingStrategy
nel campobidStrategy
nella risorsaLineItem
oAdGroup
. - Il campo
thirdPartyMeasurementSettings
è stato rinominatothirdPartyMeasurementConfigs
nell'oggettoYoutubeAndPartnersSettings
e l'oggettoYoutubeAndPartnersThirdPartyMeasurementSettings
è stato rinominato inThirdPartyMeasurementConfigs
. 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 risorsaInsertionOrder
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.