Esegui la migrazione dall'API Display & Video 360 v4 alla versione v5

Ultimo aggiornamento: 22-10-2026

Avviso: la versione 5 è in versione beta aperta. Durante la fase beta, potrebbero essere apportate modifiche che provocano un errore alla versione 5, che verranno elencate nelle note di rilascio dell'API Display & Video 360. Questo documento verrà aggiornato in base alle esigenze per riflettere la versione beta pubblicata.

Esegui la migrazione della tua applicazione

La migrazione dalla versione 4 alla versione 5 richiede l'aggiornamento degli URL degli endpoint per chiamare la versione 5, l'aggiornamento dell'applicazione per tenere conto delle modifiche che provocano un errore e la revisione di eventuali nuove funzionalità che potrebbero essere utili per l'integrazione.

Aggiorna le chiamate API dalla versione v4 alla versione v5

Per utilizzare la versione 5 anziché la versione 4, devi aggiornare le richieste in modo che utilizzino i nuovi endpoint della versione 5.

Ad esempio, per chiamare il metodo advertisers.get con v4, utilizza il seguente URL:

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

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

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

Se utilizzi una libreria client per inviare richieste all'API, utilizza la versione più recente della libreria client e aggiorna la configurazione per utilizzare la versione v5.

Apporta le modifiche desiderate

La versione 5 dell'API Display & Video 360 introduce una serie di modifiche che provocano un errore. Esamina le seguenti istruzioni e apporta le modifiche necessarie in base al tuo utilizzo attuale dell'API Display & Video 360.

Per un elenco esaustivo delle differenze tra le versioni v4 e v5 dell'API Display & Video 360, consulta le note di rilascio.

Aggiorna il recupero e il targeting delle origini dell'inventario per utilizzare i nuovi ID e tipi

L'API Display & Video 360 v5 modifica il modo in cui vengono recuperati e scelti come target i deal delle origini dell'inventario e i pacchetti di aste.

Nella versione 4, le risorse InventorySource recuperate utilizzando il servizio inventorySources rappresentano sia i deal dell'origine dell'inventario sia i pacchetti di aste. Sia i deal sia i pacchetti di aste vengono scelti come target utilizzando TARGETING_TYPE_INVENTORY_SOURCE.

Nella versione 5, i deal dell'origine dell'inventario e i pacchetti di aste vengono gestiti separatamente:

• I deal dell'origine dell'inventario vengono scelti come target utilizzando TARGETING_TYPE_INVENTORY_SOURCE_DEAL, recuperati utilizzando i servizi advertisers.inventorySources e partners.inventorySources e scelti come target utilizzando il campo AssignedTargetingOption inventorySourceDetails.
• I pacchetti di aste vengono scelti come target utilizzando TARGETING_TYPE_AUCTION_PACKAGE, recuperati utilizzando il servizio targetingTypes.targetingOptions e scelti come target utilizzando il campo AssignedTargetingOption auctionPackageDetails.

Questo aggiornamento modifica gli ID utilizzati per i deal e i pacchetti di aste esistenti, pertanto non puoi utilizzare gli ID risorsa InventorySource memorizzati nella cache in precedenza dopo la migrazione.

Oltre a queste modifiche, la versione 5 rimuove anche la possibilità di creare, aggiornare e modificare gli accessor delle origini dell'inventario.

Aggiorna la logica di targeting per pubblico per le risorse Demand Gen e YouTube

La versione 5 dell'API Display & Video 360 aggiorna la logica di targeting per pubblico per le risorse Demand Gen e YouTube in modo da utilizzare singole opzioni assegnate per ogni elenco del segmento di pubblico di destinazione.

Nella versione 4, tutto il targeting per pubblico viene gestito utilizzando TARGETING_TYPE_AUDIENCE_GROUP.

Nella versione v5, il targeting per pubblico assegnato ai gruppi di annunci Demand Gen e di YouTube viene gestito utilizzando uno dei seguenti tipi di targeting e campi della risorsa AssignedTargetingOption, a seconda del tipo di pubblico:

• TARGETING_TYPE_COMBINED_AUDIENCE utilizzando combinedAudienceDetails
• TARGETING_TYPE_CUSTOM_LIST utilizzando customListDetails
• TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE utilizzando firstPartyAndPartnerAudienceDetails
• TARGETING_TYPE_GOOGLE_AUDIENCE utilizzando googleAudienceDetails
• TARGETING_TYPE_LOOKALIKE_AUDIENCE utilizzando lookalikeAudienceDetails

Gli elementi pubblicitari continueranno a utilizzare un unico TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption per gestire il targeting per pubblico per tutti i tipi.

Esegui l'upgrade all'API Data Manager per la gestione dei segmenti di pubblico Customer Match

La versione 5 dell'API Display & Video 360 rimuove la possibilità di creare e gestire l'appartenenza ai segmenti di pubblico Customer Match rimuovendo i seguenti metodi:

• firstPartyAndPartnerAudiences.create
• firstPartyAndPartnerAudiences.editCustomerMatchMembers
• firstPartyAndPartnerAudiences.patch

Per continuare a gestire i segmenti di pubblico Customer Match, esegui l'upgrade dei tuoi workflow per utilizzare l'API Data Manager.

Aggiungi il supporto per il recupero degli ordini di inserzione Out of Home digitale

L'API Display & Video 360 v5 aggiunge il supporto per il recupero degli ordini di inserzione out of home digitale.

Se i tuoi inserzionisti utilizzano la pubblicità out of home digitale, esegui l'upgrade di qualsiasi integrazione che chiama advertisers.insertionOrders.list in previsione dell'inclusione delle risorse InsertionOrder con il valore del campo insertionOrderType di OUT_OF_HOME.

Nella versione 5, gli elementi pubblicitari negli ordini di inserzione Out of Home digitale continueranno a essere recuperabili come nella versione 4.

Aggiorna i riferimenti ad Adloox in Peer39

Nella versione 5, i campi e i valori enum che fanno riferimento all'integrazione dell'idoneità al brand di terze parti di Display & Video 360 con Adloox (noto anche come Scope3) sono stati aggiornati a Peer39:

• Il campo ThirdPartyVerifierAssignedTargetingOptionDetails adloox è stato sostituito da peer39.
• I valori enum PartnerCostType PARTNER_COST_TYPE_ADLOOX e PARTNER_COST_TYPE_ADLOOX_PREBID sono stati sostituiti da PARTNER_COST_TYPE_PEER39 e PARTNER_COST_TYPE_PEER39_PREBID.

Aggiorna i campi per gli elementi pubblicitari, i gruppi di annunci e gli annunci di YouTube

Nella versione 5, vari campi delle risorse LineItem, AdGroup e AdGroupAd sono stati rimossi o aggiornati. Aggiorna la logica di recupero delle risorse per tenere conto di queste modifiche.

Nella risorsa LineItem:

• Il campo YoutubeAndPartnersSettings relatedVideoIds è stato sostituito da relatedVideos.

Nelle risorse LineItem e AdGroup:

• I campi audienceExpansionSeedListExcluded e audienceExpansionLevel di TargetingExpansionConfig sono stati rimossi.

Nella risorsa AdGroupAd:

• È stato aggiunto un campo containsSyntheticMedia.
• Il campo trackingUrl negli oggetti AudioAd, CommonInStreamAttribute e VideoPerformanceAd è stato suddiviso in due campi, trackingUrl e userSpecifiedTrackingUrl, per distinguere l'URL utilizzato per il monitoraggio dall'URL di monitoraggio specificato dall'utente.

Rimuovi i riferimenti ai valori enum deprecati

Nella versione 5, i valori enum precedentemente deprecati sono stati rimossi completamente. Sebbene l'utilizzo di questi valori nelle richieste all'API generi un errore nella versione 4, questa modifica rimuove qualsiasi riferimento a questi valori dalle librerie client della versione 5. Eventuali riferimenti a questi valori deprecati nel codice potrebbero causare errori durante l'upgrade alla versione 5.

I tipi di enum che hanno valori interessati includono ContentRatingTier, GoogleAudienceType, SdfVersion e SensitiveCategory. Consulta le nostre note di rilascio per un elenco completo di tutti i valori enum rimossi.

Esamina le nuove funzionalità

Oltre alle modifiche che provocano un errore, la versione 5 introduce anche le seguenti nuove funzionalità:

• Gestione completa del targeting per esclusione di video e canali YouTube a livello di inserzionista nei tipi di targeting TARGETING_TYPE_YOUTUBE_VIDEO e TARGETING_TYPE_YOUTUBE_CHANNEL. Nella versione 4, questo targeting era di sola lettura.
• La possibilità di creare risorse Out of Home digitale InsertionOrder.
• Supporto per i gruppi di annunci che utilizzano le creatività assegnate per generare annunci tramite l'aggiunta dei campi AdGroup adSource e creativeAssignments e del campo AdGroupAd parentCreativeId.
• La possibilità di creare e recuperare risorse LookalikeAudience.
• Un nuovo campo containsSyntheticMedia nella risorsa AdGroupAd.