Annunciati ritiri

Questa pagina elenca le date di deprecazione e ritiro per le versioni API e le singole funzionalità dell' API Display & Video 360.

Le date di deprecazione e ritiro dell'API verranno annunciate anche sul blog per sviluppatori di Google Ads.

Deprecazioni delle versioni

Le versioni dell'API Display &Video 360 vengono rilasciate, deprecate e ritirate regolarmente. Questi passaggi sono definiti come segue:

• Rilascio: la versione esce dallo stato alpha o beta ed è considerata stabile. Potrebbero essere ancora rilasciate aggiunte di funzionalità per la versione.
• Deprecazione: la versione viene ritirata e viene annunciata una data di fine del supporto (ritiro) . Gli utenti devono eseguire la migrazione a una versione più recente prima della data di ritiro. Non verranno più rilasciate aggiunte di funzionalità per la versione.
• Ritiro: la versione non è più supportata. Le richieste effettuate alla versione restituiscono un errore.

Questa tabella elenca tutte le versioni principali esistenti dell'API Display &Video 360, le relative date di rilascio e le date di deprecazione e ritiro, se annunciate.

Versione API	Data di uscita	Data di deprecazione	Data di ritiro	Guida alla migrazione
v4	27 marzo 2025
v3	31 ottobre 2023	2 aprile 2025	7 ottobre 2025	Eseguire la migrazione da v3 a v4
v2	6 dicembre 2022	15 febbraio 2024	3 settembre 2024	Eseguire la migrazione da v2 a v3
v1	9 marzo 2020	13 marzo 2023	14 settembre 2023	Eseguire la migrazione da v1 a v2

Funzionalità deprecate

Segui il nostro blog per sviluppatori di Google Ads per gli annunci di imminenti deprecazioni di funzionalità importanti.

Questa tabella elenca tutte le deprecazioni di funzionalità annunciate che interessano le versioni live, fornendo la data di validità iniziale e una descrizione della deprecazione con azioni consigliate e link alla documentazione pertinente:

Funzionalità	Data di validità iniziale	Descrizione
Gestione del targeting di ordini di inserzione e campagne nell'API Display &Video 360 e nei file di dati strutturati	23 febbraio 2026	Il 23 febbraio 2026, Display &Video 360 ritirerà il targeting di ordini di inserzione e campagne. Verranno apportate modifiche all'API Display &Video 360 e ai file di dati strutturati (SDF) per allinearli a questa modifica. Nell'API Display &Video 360, un sottoinsieme di metodi verrà ritirato e restituirà un errore se chiamato. Nei file SDF, le colonne di targeting nei file degli ordini di inserzione Insertion Order e delle campagne Campaign non verranno più compilate al momento del download e dovranno essere vuote al momento del caricamento. È consigliabile che gli utenti assegnino il targeting direttamente agli elementi pubblicitari al momento della loro creazione. I seguenti metodi dell'API Display &Video 360 restituiranno un errore 404 se chiamati: advertisers.campaigns.listAssignedTargetingOptions advertisers.campaigns.targetingTypes.assignedTargetingOptions.get advertisers.campaigns.targetingTypes.assignedTargetingOptions.list advertisers.insertionOrders.listAssignedTargetingOptions advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.delete advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.get advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list advertisers.lineItems.generateDefault Le voci SDF delle campagne con valori assegnati alle seguenti colonne non verranno caricate: Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Geography Targeting - Include Geography Targeting - Exclude Language Targeting - Include Language Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Environment Targeting Le voci SDF degli ordini di inserzione con valori assegnati alle seguenti colonne non verranno caricate: Geography Targeting - Include Geography Targeting - Exclude Proximity Targeting Proximity Location List Targeting Language Targeting - Include Language Targeting - Exclude Device Targeting - Include Device Targeting - Exclude Browser Targeting - Include Browser Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Channel Targeting - Include Channel Targeting - Exclude Site Targeting - Include Site Targeting - Exclude App Targeting - Include App Targeting - Exclude App Collection Targeting - Include App Collection Targeting - Exclude Category Targeting - Include Category Targeting - Exclude Content Genre Targeting - Include Content Genre Targeting - Exclude Keyword Targeting - Include Keyword Targeting - Exclude Keyword List Targeting - Exclude Audience Targeting - Include Audience Targeting - Exclude Affinity & In Market Targeting - Include Affinity & In Market Targeting - Exclude Custom List Targeting Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Daypart Targeting Daypart Targeting Time Zone Environment Targeting Viewability Omid Targeting Enabled Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Position Targeting - Audio Position In Content Video Player Size Targeting Content Duration Targeting Content Stream Type Targeting Audio Content Type Targeting Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Connection Speed Targeting Carrier Targeting - Include Carrier Targeting - Exclude
Dichiarare se gli elementi pubblicitari pubblicano annunci politici dell'UE	8 settembre 2025	A partire dall'8 settembre 2025, quando crei un nuovo elemento pubblicitario utilizzando l'API Display &Video 360 o i file SDF, dovrai dichiarare se l'elemento pubblicitario pubblicherà o meno annunci politici dell'Unione Europea. Queste dichiarazioni possono essere effettuate nei seguenti modi: Utilizzando il campo containsEuPoliticalAds nella risorsa LineItem dell'API Display & Video 360. Puoi anche effettuare questa dichiarazione utilizzando i nuovi campi nelle richieste advertisers.lineItems.duplicate e advertisers.lineItems.generateDefault. Utilizzando la colonna Contains EU Political Ads nel tipo di file degli elementi pubblicitari SDF v9. Se l'inserzionista principale non conterrà elementi pubblicitari che pubblicano annunci politici dell'UE, puoi effettuare la dichiarazione a livello di inserzionista utilizzando il containsEuPoliticalAds campo nella risorsa Advertiser dell'API Display & Video 360. Se questo campo è impostato su DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, a tutti i nuovi elementi pubblicitari dell'inserzionista verrà assegnato lo stesso valore, se non diversamente specificato, e tutti gli elementi pubblicitari esistenti dell'inserzionista verranno aggiornati per utilizzare lo stesso valore, se non è già stato impostato un valore. La dichiarazione di un elemento pubblicitario può essere aggiornata in qualsiasi momento dopo la creazione utilizzando l'interfaccia utente, l'API o il file SDF. Se non puoi effettuare la dichiarazione a livello di inserzionista o hai dichiarato che gli annunci politici dell'UE potrebbero essere pubblicati nel tuo inserzionista, aggiorna l'integrazione dell'API Display & Video 360 e dei file SDF prima dell'8 settembre 2025 per evitare un'interruzione del servizio: Imposta il campo containsEuPoliticalAds in una nuova risorsa LineItem quando effettui una richiesta advertisers.lineItems.create. Imposta il campo containsEuPoliticalAds nel corpo della richiesta di tutte le richieste advertisers.lineItems.duplicate e advertisers.lineItems.generateDefault. Esegui la migrazione per utilizzare i file di dati strutturati v9 e imposta la colonna Contains EU Political Ads su Yes o No per tutti i nuovi elementi pubblicitari al momento del caricamento. Consulta la nostra guida alla migrazione a v9 per istruzioni passo passo. Prima di aggiornare il targeting geografico per un elemento pubblicitario esistente utilizzando l'API Display &Video 360 o i file SDF, aggiorna l'elemento pubblicitario per fornire una dichiarazione.
Impostazioni delle categorie di contenuti per gli elementi pubblicitari YouTube e partner	12 giugno 2025	Il 12 giugno 2025, le configurazioni delle categorie di contenuti per i singoli elementi pubblicitari YouTube e partner non saranno più modificabili a livello di elemento pubblicitario nell'ambito di un aggiornamento dell'esperienza di idoneità al brand. Le impostazioni delle categorie di contenuti verranno invece controllate esclusivamente a livello di inserzionista. Per adattarsi a questa modifica, verranno apportate le seguenti modifiche all'API Display &Video 360 e ai file di dati strutturati: Il campo contentCategory negli oggetti YoutubeAndPartnersSettings delle risorse LineItem di YouTube e partner non verrà più aggiornato. Verrà rimosso completamente in un secondo momento. La colonna TrueView Content Filter nei file SDF degli elementi pubblicitari non sarà più scrivibile. Per evitare interruzioni del servizio: Recupera il campo effectiveContentCategory al posto del campo contentCategory quando esamini gli elementi pubblicitari YouTube e partner nell'API. Smetti di modificare la colonna TrueView Content Filter quando aggiorni le voci degli elementi pubblicitari SDF. Lascia vuota la colonna quando crei nuovi elementi pubblicitari.
Aggiornamenti del budget degli elementi pubblicitari con l'ottimizzazione degli ordini di inserzione	12 giugno 2025	A partire dal 12 giugno 2025, non potrai più aggiornare le impostazioni del budget per gli elementi pubblicitari con ordini di inserzione principali impostati per l'ottimizzazione utilizzando le strategie di offerta automatiche. Per evitare interruzioni del servizio: Nell'API: controlla se il InsertionOrder principale di un elemento pubblicitario ha impostato bidStrategy.maximizeSpendAutoBid o bidStrategy.performanceGoalAutoBid. In caso affermativo, non tentare di aggiornare il campo del budget LineItem utilizzando advertisers.lineItems.patch. Nei file SDF: controlla se la voce SDF per l'ordine di inserzione principale dell'elemento pubblicitario ha la colonna Insertion Order Optimization impostata su TRUE. In caso affermativo, non tentare di aggiornare le colonne Budget Type o Budget Amount per la voce SDF dell'elemento pubblicitario .
Limitazioni dei siti per i file di dati strutturati	12 giugno 2025	A partire dal 12 giugno 2025, rimuoveremo una limitazione esistente per gli URL scelti come target nelle voci SDF che impediva l'inclusione dei siti più recenti. I file SDF corrisponderanno invece al comportamento dell'API e dell'interfaccia utente e consentiranno il targeting degli URL purché siano formattati correttamente. Questo è pertinente alle colonne Site Targeting - Include e Site Targeting - Exclude nei file degli ordini di inserzione e degli elementi pubblicitari.
Colonna "Bid Multipliers" nei file di dati strutturati degli elementi pubblicitari	1° maggio 2025	Il 1° maggio 2025, le voci nei file di dati strutturati degli elementi pubblicitari che tentano di impostare la colonna "Bid Multipliers" non riusciranno a creare o aggiornare la risorsa al momento del caricamento del file.
Richiedere l'origine dell'inventario dei partner video per gli elementi pubblicitari Demand Gen nei file di dati strutturati	22 aprile 2025	A partire dal 22 aprile 2025, dovrai includere il valore "Video Partners" nella colonna TrueView Inventory Source Targeting delle voci degli elementi pubblicitari con un valore della colonna Type pari a "Demand Gen". Una volta avviata questa applicazione, il valore verrà compilato automaticamente per gli elementi pubblicitari esistenti e incluso quando scarichi nuovi file di dati strutturati. Per evitare interruzioni del servizio: Aggiorna l'integrazione in modo da includere il valore "Video Partners" in tutte le voci degli elementi pubblicitari Demand Gen. Aggiorna l'integrazione per gestire le origini dell'inventario Demand Gen a livello di gruppo di annunci utilizzando le colonne dei gruppi di annunci SDF v8.1 Demand Gen Inventory Source Strategy e Demand Gen Enabled Inventory Sources.
Campagne video per azione nei file di dati strutturati	22 aprile 2025	Il 22 aprile 2025, non potrai più creare elementi pubblicitari per le campagne video per azione utilizzando i file di dati strutturati, poiché verrà eseguito l'upgrade a Demand Gen. Le voci degli elementi pubblicitari che tentano di essere caricate con un valore della Subtype pari a "Action" e un valore della Type pari a "TrueView" non verranno caricate. Per evitare interruzioni del servizio, aggiorna l'integrazione in modo da utilizzare Demand Gen anziché le campagne video per azione.
Durata dell'inclusione infinita per i segmenti di pubblico proprietari	7 aprile 2025	Il 7 aprile 2025, le risorse FirstAndThirdPartyAudience non consentiranno più una durata dell'inclusione del pubblico infinita. firstAndThirdPartyAudiences.create e firstAndThirdPartyAudiences.patch richieste che impostano il valore del campo membershipDurationDays su 10.000 restituiranno un errore 400. I segmenti di pubblico esistenti con un valore del campo membershipDurationDays pari a 10.000 verranno aggiornati a 540 e la nuova durata dell'inclusione verrà applicata retroattivamente alle inclusioni esistenti. In questo modo, tutte le inclusioni precedenti a 540 giorni scadranno. Per evitare interruzioni del servizio: Verifica che l'integrazione non imposti il valore del campo membershipDurationDays dei segmenti di pubblico nuovi o esistenti su 10.000. Aggiorna le inclusioni dei segmenti di pubblico Customer Match esistenti utilizzando firstAndThirdPartyAudiences.editCustomerMatchMembers. Aggiorna regolarmente le inclusioni dei segmenti di pubblico Customer Match per assicurarti che le dimensioni dell'elenco dei segmenti di pubblico non si riducano involontariamente. Nella versione 4, questa modifica si riflette nelle risorse FirstPartyAndPartnerAudience.
Algoritmo di offerta personalizzata e attività Floodlight non corrispondenti	1° aprile 2025	Il 1° aprile 2025: advertisers.lineItems.create richieste che tentano di impostare il campo floodlightActivityConfigs dell'oggetto ConversionCountingConfig e il campo customBiddingAlgorithmId degli oggetti MaximizeSpendBidStrategy o PerformanceGoalBidStrategy che non utilizzano attività Floodlight corrispondenti restituiranno un errore 400. advertisers.lineItems.patch richieste che tentano di aggiornare il campo floodlightActivityConfigs dell'oggetto ConversionCountingConfig mentre il campo customBiddingAlgorithmId degli oggetti MaximizeSpendBidStrategy o PerformanceGoalBidStrategy è impostato restituiranno un errore 400. Le voci nei file di dati strutturati degli elementi pubblicitari che tentano di aggiornare la colonna "Conversion Floodlight Activity Ids" quando la colonna "Algorithm Id" è impostata non verranno aggiornate al momento del caricamento del file. customBiddingAlgorithms.patch, customBiddingAlgorithms.rules.create, customBiddingAlgorithms.scripts.create richieste per le risorse CustomBiddingAlgorithm assegnate a un elemento pubblicitario restituiranno un errore. Per evitare interruzioni del servizio, aggiorna l'integrazione in modo da: Verificare che le attività Floodlight pertinenti siano assegnate a un elemento pubblicitario prima o contemporaneamente all'assegnazione di un algoritmo di offerta personalizzata. Annullare l'assegnazione degli algoritmi di offerta personalizzata esistenti a tutti gli elementi pubblicitari prima di tentare di aggiornarli.

Deprecazioni di funzionalità precedenti

Per informazioni sulle deprecazioni annunciate che interessano le versioni ritirate dell'API Display & Video 360, consulta le deprecazioni archiviate.