Modifiche a supporto del Regolamento dell'Unione europea sugli annunci politici nell'API Google Ads e negli script Google Ads

Giovedì 7 agosto 2025

Cosa cambierà?

Come annunciato l'anno scorso, Google smetterà di pubblicare propaganda politica nell'Unione Europea in vista dell'entrata in vigore di un nuovo regolamento a ottobre 2025. Il 3 settembre 2025, l'API Google Ads e gli script Google Ads implementeranno le misure relative a questa modifica. Se utilizzi uno di questi prodotti per creare o gestire campagne, potresti dover aggiornare la tua applicazione per gestire queste applicazioni prima del 3 settembre 2025.

Supporto API per l'autodichiarazione degli annunci politici nell'UE

L'API Google Ads e gli script Google Ads ora supportano l'autodichiarazione relativa alla presenza o meno di annunci politici dell'UE in una campagna. Scopri che cosa si intende per annuncio politico dell'UE qui. Le versioni v19.2, v20.1 e v21 dell'API contengono un nuovo campo denominato contains_eu_political_advertising nell'oggetto Campaign. I valori possibili e il loro significato sono mostrati nella tabella seguente.

Valore	Significato
CONTAINS_EU_POLITICAL_ADVERTISING	La campagna include annunci politici dell'UE.
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING	La campagna non include annunci politici dell'UE.
UNSPECIFIED	Nella campagna manca l'autodichiarazione relativa agli annunci politici dell'UE.

Puoi recuperare lo stato di autodichiarazione di una campagna nell'API Google Ads eseguendo la seguente query utilizzando i metodi Search o SearchStream di GoogleAdsService. Per gli script Google Ads, utilizza i metodi AdsApp.search o AdsApp.report.

select campaign.id, campaign.contains_eu_political_advertising from campaign

Se utilizzi le librerie client dell'API Google Ads, potresti dover scaricare l'ultima versione della libreria per utilizzare questa funzionalità nelle versioni v19 e v20 dell'API.

Modifiche alla convalida e all'applicazione delle API

Il 3 settembre 2025, l'API Google Ads e gli script Google Ads inizieranno ad applicare i seguenti controlli nelle versioni v19 e v20 dell'API.

• Tutte le nuove campagne create tramite l'API Google Ads o gli script Google Ads devono impostare il campo contains_eu_political_advertising. La chiamata API per creare una nuova campagna utilizzando CampaignService.MutateCampaigns non andrà a buon fine e restituirà un errore FieldError.REQUIRED se questo campo non è impostato. Gli script Google Ads applicheranno questi controlli durante la creazione di campagne utilizzando i metodi AdsApp.mutate o AdsApp.mutateAll.
• Tutte le campagne esistenti devono impostare il campo contains_eu_political_advertising prima di tentare di modificare proximity, location, o location_group il targeting a livello di campagna o di gruppo di annunci. La chiamata API per creare o aggiornare questi criteri della campagna utilizzando il metodo CampaignCriterionService.MutateCampaignCriteria per le campagne esistenti non andrà a buon fine e restituirà un errore CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se la campagna non ha completato l'autodichiarazione. Anche la chiamata API per creare o aggiornare questi criteri del gruppo di annunci utilizzando AdGroupCriterionService.MutateAdGroupCriteria non andrà a buon fine se la campagna non ha completato l'autodichiarazione. Gli script Google Ads applicheranno questi controlli quando tenteranno di modificare il targeting utilizzando i metodi AdsApp.mutate, AdsApp.mutateAll, AdsApp.Campaign.addProximity e AdsApp.Campaign.addLocation.
• Queste applicazioni si applicano anche ad altri meccanismi che puoi utilizzare per creare campagne, ad esempio l'esecuzione di job batch e l'utilizzo del metodo GoogleAdsService.Mutate per creare e aggiornare entità.
• Il tentativo di pianificare un nuovo esperimento utilizzando il metodo ExperimentService.ScheduleExperiment genererà un errore ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION se contains_eu_political_advertising declaration non è presente nelle campagne bozza sperimentali.
• Se utilizzi la funzionalità di caricamento collettivo negli script Google Ads, consulta la documentazione del prodotto per scoprire di più sulle modifiche al modello di foglio di lavoro richieste nell'ambito di questa modifica.

Questi controlli sono già applicati nella versione v21 dell'API Google Ads.

Quale sarà l'impatto sulla pubblicazione della mia campagna?

La pubblicazione nell'UE di qualsiasi campagna che ha dichiarato annunci politici dell'UE impostando contains_eu_political_advertising su true verrà interrotta il 22 settembre 2025. Per saperne di più, consulta il nostro Centro assistenza.

Le campagne esistenti senza una dichiarazione non saranno interessate per il momento. Ti consigliamo di aggiornare il prima possibile le campagne esistenti nei tuoi account con una dichiarazione appropriata. Puoi recuperare le campagne senza una dichiarazione utilizzando la seguente query GAQL con i metodi Search o SearchStream di GoogleAdsService.

select campaign.id, campaign.contains_eu_political_advertising
  from
    campaign
  where
    campaign.contains_eu_political_advertising NOT IN
    (
       'CONTAINS_EU_POLITICAL_ADVERTISING',
       'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING'
    )

Cosa devo fare?

Se la tua applicazione utilizza l'API Google Ads o gli script Google Ads per creare o gestire le campagne, assicurati di aggiornarla per gestire queste applicazioni prima del 3 settembre 2025.

Come posso ricevere assistenza?

Se hai altre domande su questa modifica, contatta i canali di assistenza per l'API Google Ads o di assistenza per gli script Google Ads.

 - Anash P. Oommen, team API Google Ads

Etichette: campaign, google-ads-api, google-ads-scripts