Note di rilascio

Consulta la sezione Funzionalità deprecate per un elenco aggiornato dei deprecamenti delle funzionalità attuali e pianificati.

Versioni principali e secondarie v24

L'API Google Ads v24 include le nuove funzionalità, gli aggiornamenti e le modifiche che causano interruzioni seguenti.

v24.2 (24/06/2026)

Nella versione 24.2 dell'API Google Ads sono stati aggiunti i seguenti nuovi aggiornamenti e funzionalità. Le versioni secondarie come la v24.2 non contengono modifiche che provocano errori.

Funzionalità e aggiornamenti Tipo Descrizione
Annunci
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT Nuovo valore enum Genera informazioni di testo dalla pagina di destinazione da mostrare nel riquadro del coinvolgimento per le istanze DemandGenVideoResponsiveAd (che sono attive per impostazione predefinita a partire da questa versione dell'API).
Asset
AssetGroup.google_local_services_info Nuovo campo È stato aggiunto il supporto per le informazioni sugli annunci di Servizi locali (ID categoria e callout) nelle campagne Performance Max.
AssetGroupSignal.local_services_id Nuovo campo Aggiunta per supportare gli indicatori dell'ID servizio annunci di Servizi locali nelle campagne Performance Max.
AssetGroupSignal.vertical_ads_item_group_rule_list Nuovo campo Aggiunte per supportare le regole dei gruppi di elementi degli annunci verticali per la selezione degli elementi dai feed verticali allegati nelle campagne Performance Max. Questa funzionalità è disponibile solo per gli account nella lista consentita.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN Nuovo valore enum / errore Restituito quando si tenta di rimuovere tutti i gruppi di asset da una campagna.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS Nuovo valore enum / errore Restituito quando si tenta di rimuovere tutti gli indicatori da un gruppo di asset.
Campagne
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled		 Nuovi campi Supporta l'identificazione delle campagne Performance Max per i servizi locali.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps Nuovo campo Include Google Maps nei canali selezionabili per i gruppi di annunci Demand Gen.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN Nuovo valore enum / errore Restituito quando si tenta di rimuovere tutte le località da una campagna Performance Max per i servizi locali.
SmartCampaignErrorEnum.CREATION_FAILED Nuovo valore enum / errore Restituito durante il tentativo di creare nuove campagne intelligenti.
Conversioni
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS		 Nuovi valori enum Rappresentano le conversioni che si verificano quando un utente fa clic su un annuncio di Servizi locali e chiama, invia un messaggio o prenota l'inserzionista.
Esperimenti
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION		 Nuovi valori enum È stato aggiunto il supporto per i nuovi tipi di ExperimentType:
  • COMPARE_CAMPAIGNS: per esperimenti di mix di campagne ed esperimenti Performance Max personalizzati che confrontano più campagne dello stesso tipo o di tipi diversi in un unico esperimento.
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: per gli esperimenti di ottimizzazione di Performance Max per la personalizzazione del testo e l'espansione dell'URL finale.
Generale
Asset.synthetic_content_info
Ad.synthetic_content_info		 Nuovi campi Contenere attestazioni per i contenuti sintetici/generati con l'AI, suddivise in advertiser_input (dichiarazioni fornite direttamente dall'inserzionista) e system_input (attestazioni rilevate automaticamente o fornite dal sistema).

È stato eseguito il backporting di questa funzionalità alle versioni 23 e 22.

Per aiutarti a pianificare il lavoro di integrazione imminente per la v25, l'interfaccia per la modifica dei campi di attestazione dell'inserzionista viene introdotta in anticipo per la v22 e versioni successive. L'interfaccia è visibile in queste versioni, ma synthetic_content_info.advertiser_attestation.status e synthetic_content_info.advertiser_attestation.source rimarranno immutabili per queste versioni.

Se tenti una richiesta di modifica su uno di questi campi, verrà restituito uno di questi errori:

"The field attempted to be mutated is immutable" (Il campo che si è tentato di modificare è immutabile) o "Field cannot be set" (Impossibile impostare il campo).

Questi campi diventeranno completamente modificabili a partire dalla versione 25. Ti consigliamo di utilizzare l'interfaccia ora per creare e testare la logica interna in modo che il sistema sia pronto per le funzionalità di scrittura complete al lancio della versione 25.
Autorizzazione da più parti Nuove funzionalità Aggiunto il supporto per le revisioni dell'autorizzazione da più parti (MPA):
Questa funzionalità è stata eseguita il backporting alle versioni v23.3, v22.2 e v21.2.
IncentiveService.FetchIncentive Modifica del comportamento Quando nella richiesta viene fornito un indirizzo email non valido, il metodo ora esegue il fallback per restituire le offerte di incentivi predefinite anziché generare un errore AuthenticationError.INVALID_EMAIL_ADDRESS.
Pianificazione
GenerateCreatorInsightsRequest.search_topics Nuovo campo Aggiunto al servizio ContentCreatorInsightsService.GenerateCreatorInsights. Questa opzione cerca i creator che parlano di un argomento nel paese specificato in country_locations (supporta la ricerca di un solo paese).
CREATOR_TOPIC_INSIGHTS Nuovo valore enum Aggiunto a InsightsKnowledgeGraphEntityCapabilities per indicare le entità per la ricerca di creator che parlano di un argomento. Queste entità devono essere utilizzate nel campo search_topics. Recuperato utilizzando AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions Nuovo tipo / opzioni Contiene opzioni di ricerca aggiuntive per gli argomenti in ListAudienceInsightsAttributes, incluse le opzioni per recuperare tutti gli argomenti supportati come attributi dei creator e il filtro per funzionalità.
GenerateCreatorInsightsRequest.supplemental_data
GenerateTrendingInsightsRequest.supplemental_data		 Nuovi campi Input facoltativi per i metodi ContentCreatorInsightsService. Se fornisci questo campo, nella risposta vengono compilati ulteriori attributi di località o del creator.
local_creator_insights
related_local_creators		 Nuovi campi Viene compilato quando supplemental_data contiene l'enumerazione LOCAL_CREATOR_DATA. Mostra i creator locali visualizzati o con sede nel paese scelto che hanno acconsentito a condividere i dati sulla posizione.
GenerateTrendingInsightsRequest.sub_country_locations Nuovo campo Aggiunta a ContentCreatorInsightsService.GenerateTrendingInsights, che consente di cercare approfondimenti sulle tendenze utilizzando la posizione del paese e le posizioni dei paesi secondari.
Report
PerformanceMaxPlacementView Estensione dei segmenti Reso segmentabile da ad_network_type.
Shopping
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads Nuovo campo Se è vero, le esclusioni dei brand vengono ignorate per gli annunci Shopping. Supportato solo per le campagne Shopping.
Targeting
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE Nuovo valore enum / errore Restituito quando si tenta di scegliere come target una lingua non consentita.
Video
DataLink.youtube_link_metadata Nuovo campo Contiene brand_channel_id per specificare l'ID del canale YouTube del brand collegato.

v24.1 (13/05/2026)

Nella versione 24.1 dell'API Google Ads sono stati aggiunti i seguenti nuovi aggiornamenti e funzionalità. Le versioni secondarie come la v24.1 non contengono modifiche che provocano errori.

Funzionalità e aggiornamenti Tipo Descrizione
Annunci
DemandGenMultiAssetAdInfo.classic_display_images Nuovo campo Immagini display personalizzate caricate pubblicate senza richiedere asset adattabili aggiuntivi.
Esperimenti
ADOPT_AI_MAX
ADOPT_BROAD_MATCH_KEYWORDS
OPTIMIZE_ASSETS
PMAX_REPLACEMENT_SHOPPING		 Nuovi valori enum È stato aggiunto il supporto per i nuovi tipi di ExperimentType:
  • ADOPT_AI_MAX: per gli esperimenti che testano come AI Max può aiutarti a coinvolgere più clienti con Google AI e le parole chiave a corrispondenza generica.
  • ADOPT_BROAD_MATCH_KEYWORDS: per gli esperimenti che testano l'impatto delle parole chiave a corrispondenza generica sul numero di ricerche in cui vengono visualizzati i tuoi annunci.
  • OPTIMIZE_ASSETS: per esperimenti personalizzati per l'ottimizzazione degli asset.
  • PMAX_REPLACEMENT_SHOPPING: per gli esperimenti che testano il rendimento delle campagne Shopping rispetto a Performance Max.
Experiment.video_experiment Nuovo campo Supporto per la configurazione di esperimenti YOUTUBE_CUSTOM esistenti costituiti da campagne video.
ExperimentArm.asset_testing_info
ExperimentArm.asset_groups
ExperimentArm.performance_max_experiment_arm_info		 Nuovi campi Mostra i campi per supportare i test degli asset, i gruppi di asset e le impostazioni di Performance Max nei gruppi sperimentali:
  • asset_testing_info: dettagli degli asset associati alle copie sperimentali degli annunci.
  • asset_groups: elenco dei gruppi di asset nel gruppo sperimentale per gli esperimenti Ottimizza asset.
  • performance_max_experiment_arm_info: impostazioni per le campagne Performance Max negli esperimenti PMAX_REPLACEMENT_SHOPPING.
Generale
CustomerUserAccess.passkey_enabled Nuovo campo Campo di sola lettura che indica se l'utente ha attivato una passkey.
Report
mobile_device_platform Nuovo segmento Consente di segmentare i report in base alla piattaforma del dispositivo dell'utente (ad esempio iOS o Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED Nuovo valore enum / errore Restituito quando la granularità temporale giornaliera, oraria o settimanale richiesta non è supportata per gli intervalli di date della query (disponibile solo per gli ultimi 37 mesi).
vertical_ads_listing_user_rating
vertical_ads_listing_venue		 Nuovi segmenti Nuovi segmenti da utilizzare per gli annunci verticali.
user_rating, venue, event_participant_display_name Nuovi criteri di filtro Filtro supportato in VerticalAdsItemGroupRuleInfo per la risorsa SharedCriterion.
Metriche dell'esperimento di controllo/trattamento Nuovi campi Sono stati aggiunti valori di controllo (control_clicks e così via), valori di trattamento (clicks e così via), stime puntuali (clicks_point_estimate e così via), margini di errore (clicks_margin_of_error e così via) e valori p (clicks_p_value e così via) in sette famiglie di metriche principali (clic, impressioni, costo, conversioni, costo per conversione, valore di conversione, valore di conversione per costo).
Metriche sulla variazione assoluta delle conversioni Nuovi campi Supporto per le Conversions stime della differenza assoluta utilizzando i campi stima puntuale, margine di errore e valore p.
Targeting
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS Nuovo valore enum / errore Restituito quando si tenta di escludere tutti i target demografici.
Video
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR Nuovo valore enum ZEFR è stato pubblicato come partner di integrazione della visibilità di terze parti.
DataLink.youtube_video.channel_id Nuovo campo Mostra l'ID canale YouTube associato al collegamento dei dati.

Versione 24 (22/04/2026)

Nella versione 24 dell'API Google Ads, che è una release principale, sono state aggiunte le seguenti nuove funzionalità, aggiornamenti e modifiche che provocano un errore.

Per indicazioni, consulta l'articolo Eseguire l'upgrade all'ultima versione.

Modifiche che provocano un errore

Stato iniziale Nuovo stato Tipo di modifica Linee guida per l'implementazione
Annunci
videos e logo_images facoltativi in DemandGenVideoResponsiveAdInfo Campi obbligatori Cambiamento comportamentale Fornisci videos e logo_images quando crei o modifichi annunci video Demand Gen adattabili.
Facoltativo: videos, business_name e logo_images in VideoResponsiveAdInfo Campi obbligatori Cambiamento comportamentale Fornisci videos, business_name e logo_images quando crei o modifichi annunci video adattabili. Tieni presente che VideoResponsiveAdInfo ora è modificabile.
Campagne
Campaign.video_brand_safety_suitability Nessuno Rimozione Il controllo dell'idoneità a livello di campagna viene rimosso. L'idoneità per la sicurezza del brand è ancora disponibile a livello di cliente. Utilizza invece Customer.video_brand_safety_suitability.
Conversioni
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Nessuno Rimozione La categoria di utenti Iscrizioni al programma fedeltà è stata rimossa. Rimuovi i riferimenti al codice.
Pianificazione
Tipo di InsightsAudienceAttributeGroup per topic_audience_combinations Tipo di common.InsightsAudienceAttributeGroup Modifica del comportamento / tipo Le integrazioni delle librerie client tipizzate devono essere aggiornate per utilizzare i nuovi spazi dei nomi delle risorse.
Campo youtube_select_lineups in ReachPlanService.ListPlannableProducts Nessuno Rimozione Passa all'utilizzo delle formazioni di youtube_select_lineup_targeting.
Campo is_brand_connect_creator in ContentCreatorInsightsService.GenerateCreatorInsights e GenerateTrendingInsights Nessuno Rimozione Controlla invece se un creator ha CREATOR_PARTNERSHIPS disponibili in partnership_opportunities.
geo_modifiers e biddable_keywords in KeywordPlanIdeaService.GenerateKeywordForecastMetrics geo_target_constants e keywords Rinomina / rimozione Sostituito da CampaignToForecast.geo_target_constants[] e ForecastAdGroup.keywords[].
Campi del piano / delle previsioni delle parole chiave ritirati in GenerateKeywordForecastMetrics Nessuno Rimozione Sono stati rimossi i seguenti campi e tipi di piani / previsioni: Aggiorna le integrazioni di conseguenza.
Report
Segmento ad_sub_network_type in campaign_budget Nessuno Rimozione È stato rimosso il segmento ad_sub_network_type per la risorsa campaign_budget.
click_type segmento nelle visualizzazioni degli asset Nessuno Rimozione Segmento rimosso dalle visualizzazioni AdGroupAsset, CampaignAsset e CustomerAsset.
Video
Errore parziale consentito in ShareablePreviewService.GenerateShareablePreviews Nessun errore parziale Cambiamento comportamentale Le richieste non andranno a buon fine e genereranno un errore se uno degli ID al loro interno non supera la convalida.
Codici legacy ShareablePreviewError: MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST		 Rinomina / cambiamento comportamentale I codici di errore restituiti per i gruppi di asset vengono modificati per essere in linea con gli errori degli annunci dei gruppi di annunci. Aggiorna la logica di rilevamento della convalida.

Funzionalità e aggiornamenti (non distruttivi)

Funzionalità e aggiornamenti Tipo Descrizione
Annunci
Modificabilità di VideoResponsiveAdInfo Modifica del comportamento Gli oggetti informativi degli annunci video adattabili ora sono modificabili.
Asset
travel_feed_data in AssetSet Nuovo campo Aggiunta per recuperare gli attributi delle risorse del feed viaggi (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type).
Campagne
Campaign.view_through_conversion_optimization_enabled Nuovo campo Consente di attivare l'ottimizzazione delle conversioni view-through (VTC) (impostazione predefinita false) nelle campagne Demand Gen e per app.
CampaignCriterion.gender Nuova funzionalità Sono state attivate le esclusioni di genere per le campagne Performance Max in tutte le versioni dell'API Google Ads.
Conversioni
Tipi di conversione Lead Gen Nuovi valori enum Sono stati aggiunti nuovi enum di tipo di azione di conversione GA4/Firebase in ConversionActionType:
  • GOOGLE_ANALYTICS_4_GENERATE_LEAD
  • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
  • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
  • FIREBASE_ANDROID_GENERATE_LEAD
  • FIREBASE_ANDROID_QUALIFY_LEAD
  • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
  • FIREBASE_IOS_GENERATE_LEAD
  • FIREBASE_IOS_QUALIFY_LEAD
  • FIREBASE_IOS_CLOSE_CONVERT_LEAD
Generale
UserListErrorEnum.DUPLICATE_LOOKALIKE Nuovo valore enum / errore Restituito quando si tenta di creare più elenchi di segmenti di pubblico simili identici.
Pianificazione
ProductCoreAttributes campi in ListPlannableProductsResponse Nuovi campi Sono stati aggiunti descrizione del prodotto pianificabile, obiettivo di marketing, modello di costo e metodo di acquisto a ProductCoreAttributes in ListPlannableProductsResponse.
Report
CartDataSalesView Nuova risorsa per la creazione di report Mostra report che segmentano le metriche delle conversioni in base al prodotto specifico venduto (brand e così via) oltre al prodotto su cui è stato fatto clic.
Metriche non disponibili per le offerte Nuovi campi Sono state aggiunte metriche non disponibili per le offerte (metriche che mostrano le conversioni per cui le campagne non eseguono l'ottimizzazione) a tutte le risorse corrispondenti:
conversion_attribution_event_type Nuovo segmento Aggiunto a ShoppingPerformanceView.
Shopping
Campagne per app in ShoppingProduct Nuova funzionalità Campagne per app supportate all'interno della risorsa ShoppingProduct. Lo stato e i problemi relativi alle note non sono supportati.
Filtro dei prodotti basato sui tag Nuova funzionalità È stato introdotto il filtraggio dinamico utilizzando le espressioni di insiemi logici: Questa funzionalità è disponibile solo per gli account nella lista consentita.

Versioni principali e secondarie v23

L'API Google Ads v23 include le seguenti nuove funzionalità, aggiornamenti e modifiche che causano interruzioni.

v23.3 (24/06/2026)

Nella versione 23.3 dell'API Google Ads sono stati aggiunti i seguenti aggiornamenti e nuove funzionalità. Le versioni secondarie come la v23.3 non contengono modifiche che provocano un errore.

Funzionalità e aggiornamenti Tipo Descrizione
Generale
Asset.synthetic_content_info
Ad.synthetic_content_info		 Nuovi campi Contengono attestazioni per i contenuti sintetici/generati con l'AI, suddivise in advertiser_attestation (dichiarazioni fornite direttamente dall'inserzionista) e system_attestation (attestazioni rilevate automaticamente o fornite dai sistemi di Google).

Per aiutarti a pianificare il lavoro di integrazione imminente per la v25, l'interfaccia per la modifica dei campi di attestazione dell'inserzionista viene introdotta in anticipo per la v22 e versioni successive. L'interfaccia è visibile in queste versioni, ma synthetic_content_info.advertiser_attestation.status e synthetic_content_info.advertiser_attestation.source rimarranno immutabili per queste versioni.

Se tenti una richiesta di modifica su uno di questi campi, verrà restituito uno di questi errori:

"The field attempted to be mutated is immutable" (Il campo che si è tentato di modificare è immutabile) o "Field cannot be set" (Impossibile impostare il campo).

Questi campi diventeranno completamente modificabili a partire dalla versione 25. Ti consigliamo di utilizzare l'interfaccia ora per creare e testare la logica interna in modo che il sistema sia pronto per le funzionalità di scrittura complete al lancio della versione 25.
Approvazioni da più parti Nuove funzionalità Aggiunta del supporto per le revisioni delle approvazioni da più parti (MPA):

v23.2 (25/03/2026)

Nella versione 23.2 dell'API Google Ads sono stati aggiunti i seguenti nuovi aggiornamenti e funzionalità. Le versioni secondarie come la v23.2 non contengono modifiche che provocano un errore.

Funzionalità e aggiornamenti Tipo Descrizione
Asset
VideoEnhancement Nuova risorsa Contiene informazioni sugli annunci video specifiche per il miglioramento, ad esempio se è stato generato da Google o fornito dall'inserzionista. Per saperne di più, consulta la sezione Informazioni sui miglioramenti video.
AppTopCombinationView Nuova risorsa Risorsa di sola lettura per fornire approfondimenti sulle combinazioni di asset con il rendimento migliore nelle campagne per app.
CustomerAsset Nuova funzionalità È stato aggiunto il supporto per recuperare CustomerAsset con field_type impostato su BUSINESS_LOGO.
Campagne
AdGroupAd.start_date_time
AdGroupAd.end_date_time		 Nuovi campi Fornisci vincoli di pianificazione più granulari per le date della campagna. Questa opzione è supportata solo per alcuni tipi di gruppi di annunci.
HotelSettingInfo.disable_hotel_setting Nuovo campo Consente di disattivare il feed hotel nelle campagne Demand Gen.
Generale
CustomerClientLinkError Nuovi valori enum / errori Sono stati aggiunti due nuovi codici di errore: MAX_CUSTOMER_LIMIT_REACHED e ACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Modifica del comportamento Ora viene generato un errore quando si tenta di utilizzare questa categoria di tipo di cliente dell'elenco utenti ritirato.
Pianificazione
GenerateTrendingInsights
GenerateCreatorInsights		 Nuove funzionalità È stato aggiunto il supporto per combinazioni personalizzate AND/OR di entità, argomenti e segmenti di pubblico.
ReachPlanService.GenerateReachForecast Nuovi valori enum Sono state aggiunte nuove fasce d'età targetizzabili, ad esempio AGE_RANGE_21_44 o AGE_RANGE_21_49.
youtube_select_lineup_targeting Nuovo campo Aggiunto a ReachPlanService.ListPlannableProducts, che sostituirà youtube_select_lineups. Al momento entrambi i campi sono compilati.
ReachPlanSurface Nuovo valore enum È stato aggiunto IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS come opzione della piattaforma.
Forecast Nuovo campo È stato aggiunto clicks per Massimizza i clic (CPC) di Demand Gen in ReachPlanService.GenerateReachForecast.
partnership_opportunities Nuovo campo Aggiunto a ContentCreatorInsightsService.GenerateCreatorInsights e ContentCreatorInsightsService.GenerateTrendingInsights.
Report
biddable_indirect_install_first_in_app_conversion_micros Nuovo campo Aggiunto alle risorse Campaign, Customer e AdGroup.
Video
ShareablePreviewService Nuova funzionalità Esteso per supportare le anteprime di YouTube Live impostando preview_type su YOUTUBE_LIVE_PREVIEW. UNSUPPORTED_AD_TYPE e TOO_MANY_RESOURCES_IN_REQUEST aggiunti a ShareablePreviewError. Questa funzionalità è supportata solo per alcuni tipi di annunci.

v23.1 (25/02/2026)

Nella versione 23.1 dell'API Google Ads sono stati aggiunti i seguenti nuovi aggiornamenti e funzionalità. Le versioni secondarie come la v23.1 non contengono modifiche che provocano errori.

Funzionalità e aggiornamenti Tipo Descrizione
Gestione account
advertising_partner_properties.allowed_domain Nuovo campo Aggiunta alle risorse ProductLinkInvitation e ProductLink. Il partner pubblicitario potrà pubblicare annunci solo su questo dominio.
Customer.contains_eu_political_advertising Nuovo campo Recupera lo stato della dichiarazione a livello di account relativa alla presenza o meno di pubblicità politica con targeting sull'UE e restituisce un EuPoliticalAdvertisingStatus.
Campagne
Campaign.text_guidelines Nuovo campo È stato aggiunto il supporto per le linee guida per il testo, che possono essere utilizzate con le campagne Performance Max e sulla rete di ricerca per controllare in modo programmatico gli asset di testo generati con l'AI. All'interno di text_guidelines, puoi definire term_exclusions e messaging_restrictions.
CampaignPrimaryStatusReason Nuovi valori enum Sono stati aggiunti CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED e BOOKING_CANCELLED per fornire i motivi principali dello stato delle campagne con la strategia di offerta FIXED_CPM.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure
Campaign.VideoCampaignSettings.booking_details		 Nuovi campi È stato aggiunto il supporto per l'autodichiarazione della categoria di annunci basati su prenotazione e per i dettagli della prenotazione di sola lettura.
Campaign.missing_eu_political_advertising_declaration Nuovo campo Supporta l'interrogazione e il filtro delle campagne per le quali mancano dichiarazioni che indichino se contengono pubblicità politica rivolta all'UE.
Conversioni
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS Nuovo valore enum Supporta il monitoraggio degli utenti che guardano un annuncio e in seguito un video dello stesso canale.
Generale
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED Nuovo valore enum / errore Restituito quando si tenta di scegliere come target solo la categoria indeterminata nelle dimensioni demografiche.
Incentivi
IncentiveErrorEnum Nuovi valori enum / errori Sono stati aggiunti due nuovi codici di errore: MAX_INCENTIVES_REDEEMED e ACCOUNT_TOO_OLD. Questi errori possono essere restituiti per le richieste effettuate a partire dall'11 marzo 2026.
Pianificazione
GenerateBenchmarksMetrics Nuova funzionalità È stato aggiunto il supporto per le suddivisioni delle date utilizzando un BreakdownDefinition.
ReachPlanService.GenerateReachForecast Nuovo valore enum Aggiunta di GOOGLE_DISPLAY_NETWORK come piattaforma selezionabile come target per Massimizza le conversioni di Demand Gen.
GenerateTrendingInsights Nuovi campi Sono state aggiunte informazioni sulla linea di tendenza storica in TrendInsightDataPoint - TrendInsights durante la ricerca per argomento.
Report
Metriche di frequenza degli utenti unici Nuovi campi Sono state aggiunte nuove metriche che indicano il numero di utenti che hanno visto il tuo annuncio almeno due, tre, quattro, cinque o dieci volte: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus e unique_users_ten_plus.
SearchTermMatchSource Nuovo valore enum È stato aggiunto VERTICAL_ADS_DATA_FEED per supportare i feed di dati degli annunci verticali, ad esempio il targeting delle entità degli annunci per i viaggi.
YouTubeVideoUpload
YouTubeVideoUpload Nuovo servizio / risorsa È stato aggiunto il servizio YouTubeVideoUpload per supportare il caricamento e la gestione dei video su YouTube e la risorsa YouTubeVideoUpload per supportare il recupero dello stato di caricamento e dei metadati. Questa funzionalità è supportata solo per REST e la libreria client Python.

v23 (28/01/2026)

Nella versione 23 dell'API Google Ads, che è una release principale, sono state aggiunte le seguenti nuove funzionalità, aggiornamenti e modifiche che provocano un errore.

Per indicazioni, consulta l'articolo Eseguire l'upgrade all'ultima versione.

Modifiche che provocano un errore

Stato iniziale Nuovo stato Tipo di modifica Linee guida per l'implementazione
Annunci
Condivisione degli annunci consentita AdGroupAdError.AD_SHARING_NOT_ALLOWED Cambiamento comportamentale La condivisione degli annunci tra più gruppi di annunci non è più consentita. Le richieste che tentano di condividere gli annunci restituiranno un errore AD_SHARING_NOT_ALLOWED.
Supporto per CallAd e CallAdInfo Nessuno Rimozione Il supporto per gli annunci di chiamata è stato rimosso. Consulta l'articolo del Centro assistenza Informazioni sugli annunci di chiamata.
Campagne
Campaign.start_date
Campaign.end_date		 Campaign.start_date_time
Campaign.end_date_time		 Rinomina / sostituzione Utilizza i nuovi campi data e ora per specificare i componenti temporali delle campagne. I campi originali solo data vengono rimossi.
Demand Gen
DemandGenMultiAssetAdInfo.lead_form_only Nessuno Rimozione Il campo lead_form_only è stato rimosso. Aggiorna i riferimenti nel codice.
Report
Enum e metriche aggregate dell'etichetta di rendimento degli asset Nessuno Rimozione Sono state rimosse le metriche delle etichette di rendimento delle risorse aggregate. L'enumerazione dell'etichetta di rendimento non viene più restituita per la rete di ricerca e display.

Funzionalità e aggiornamenti (non distruttivi)

Funzionalità e aggiornamenti Tipo Descrizione
Annunci
AdFormatType Nuovi valori enum Sono stati aggiunti nuovi tipi di formato: TEXT, VERTICAL_ADS_BOOKING_LINK e VERTICAL_ADS_PROMOTION.
Asset
Visualizzazione asset_group Nuovi campi Sono state aggiunte le seguenti metriche: metrics.engagements, metrics.engagement_rate e metrics.average_cpe.
Visualizzazione asset_group_asset Nuovi campi Sono state aggiunte le seguenti metriche: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views e metrics.interaction_event_types.
Asset.orientation Nuovo campo Campo di orientamento di sola lettura aggiunto agli asset immagine e video.
CampaignAsset Nuova funzionalità È stato aggiunto il supporto per recuperare gli asset della campagna con field_type impostato su HEADLINE e DESCRIPTION.
ServedAssetFieldType Nuovi valori enum Sono stati aggiunti HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE e DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO per gli asset pubblicati come sitelink.
BusinessMessageAsset Nuove funzionalità / supporto Asset di messaggi inviati all'attività aggiornati:
Fatturazione
InvoiceService.ListInvoices Nuove opzioni Ora può restituire dettagli più granulari in Invoice, tra cui la suddivisione dei costi a livello di campagna, i costi normativi dettagliati e le informazioni sugli aggiustamenti, impostando include_granular_level_invoice_details in ListInvoicesRequest.
RegulatoryFeeType
UnitOfMeasure		 Nuovi enum Sono state aggiunte enumerazioni helper per oneri normativi e unità di misura.
Campagne
CampaignError Nuovi valori enum / errori Sono stati aggiunti i codici di errore DURATION_TOO_LONG_FOR_TOTAL_BUDGET e END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
Conversioni
ConversionActionCategory Nuovo valore enum È stato aggiunto YOUTUBE_FOLLOW_ON_VIEWS per supportare il monitoraggio degli utenti che guardano un annuncio e in seguito un video dello stesso canale.
Demand Gen
DemandGenVideoResponsiveAdInfo.companion_banner Nuovo campo È stato aggiunto il supporto per i banner companion negli annunci video adattabili Demand Gen.
Incentivi
È stato aggiunto il supporto per gli incentivi Scegli la tua offerta (CYO):

Per facilitare la gestione programmatica più granulare degli errori, aggiungeremo ulteriori codici di errore a IncentivesService nelle versioni future. Ti consigliamo di monitorare gli annunci imminenti e le note di rilascio per questi nuovi codici di errore per assicurarti che le tue applicazioni possano gestire queste nuove modalità di errore.
Pianificazione
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST Nuovo valore enum Consente di creare segmenti di pubblico utilizzando gli eventi importanti in GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport e GenerateCreatorInsights.

Gli eventi importanti non sono supportati per altri metodi di AudienceInsightsService, come AudienceInsightsService.GenerateAudienceOverlap e AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates Nuovi campi / opzioni La risposta ora include le piattaforme per supportare i suggerimenti sul tasso di conversione in base ai controlli delle piattaforme (ad es. Gmail, Shorts). Supportato solo per le campagne Demand Gen.
LanguageDistribution Nuovo campo / tipo Aggiunta a YouTubeChannelInsights per fornire i dettagli sulla distribuzione delle lingue nei contenuti del canale YouTube.
BenchmarksService Nuovo servizio Confronta i dati pubblicitari di YouTube con i benchmark di settore.
AudienceInsightsService.GenerateAudienceDefinition Nuovo metodo Traduce una descrizione in formato libero di un pubblico di destinazione in attributi del segmento di pubblico corrispondenti utilizzando l'AI generativa.
YouTubeChannelInsights.relevance_score Nuovo campo Valuta la pertinenza di un creator per un argomento in base alle visualizzazioni.
TrendInsightMetrics.trend_change_percent Nuovo campo Rappresenta la variazione percentuale del valore di una tendenza nel periodo di confronto.
Consigli
GenerateRecommendationsRequest Nuovo campo is_new_customer aggiunti. Se impostato su true per i consigli CAMPAIGN_BUDGET, utilizza un modello ottimizzato per i nuovi clienti (consigliato solo per i clienti senza campagne).
Report
AdGroupAdAssetView Supporto di nuove funzionalità / metriche Ora supporta le metriche relative a impressioni, rendimento e conversioni per RESPONSIVE_DISPLAY_AD.
Segmento ad_sub_network_type Nuovo segmento Fornisce una suddivisione granulare del rendimento all'interno di una rete pubblicitaria. Inizialmente disponibile per le campagne Demand Gen su YouTube (in-stream, in-feed, Shorts). Deve essere selezionato insieme a ad_network_type.
Report di Performance Max Nuova funzionalità È stata attivata la suddivisione del tipo di rete pubblicitaria per le campagne Performance Max.
UserLocationView
GeographicView		 Supporto dei nuovi segmenti Metriche di assistenza segmentate per data di conversione: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date, cross_device_conversions_by_conversion_date e cross_device_conversions_value_by_conversion_date.
Segmenti degli annunci verticali Nuovi segmenti Sono stati aggiunti i seguenti segmenti: vertical_ads_event_participant_display_names, vertical_ads_hotel_class, vertical_ads_listing, vertical_ads_listing_brand, vertical_ads_listing_city, vertical_ads_listing_country, vertical_ads_listing_region, vertical_ads_partner_account e vertical_ads_vertical.
PerStoreView
MatchedLocationInterestView		 Nuove risorse per la creazione di report È stato aggiunto PerStoreView per eseguire query sui dettagli della sede del negozio e MatchedLocationInterestView (per le campagne AI Max) per fornire metriche sul rendimento in base alle località geografiche di interesse.
Shopping
ShoppingPerformanceView Supporto di nuove metriche Ora supporta le seguenti metriche segmentate per data di conversione: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date e value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView Supporto di nuove metriche È stato aggiunto il supporto per: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share e search_rank_lost_absolute_top_impression_share.
ShoppingProduct.product_image_uri Nuovo campo Aggiunto a ShoppingProduct.
Annunci verticali
AdGroup.vertical_ads_format_setting Nuovo campo Consente di controllare quali formati degli annunci possono essere pubblicati nelle campagne sulla rete di ricerca utilizzando i feed viaggi.
AdGroupCriterion
SharedCriterion		 Nuovi campi / criteri È stato aggiunto il tipo di criterio vertical_ads_item_group_rule_list a AdGroupCriterion e vertical_ads_item_group_rule a SharedCriterion per consentire il targeting dei gruppi di articoli nelle campagne sulla rete di ricerca con feed di viaggi.
Integrazione del feed di dati pubblicitari verticali Nuova funzionalità Ora puoi collegare un feed di dati degli annunci verticali a una campagna sulla rete di ricerca che utilizza AI Max per mostrare annunci di viaggio con link di prenotazione e promozione della proprietà insieme agli annunci di testo. Controlla i formati con vertical_ads_format_setting e definisci le regole utilizzando vertical_ads_item_group_rule. Report sulla segmentazione per AdFormatType e dimensioni del feed di dati pubblicitari verticali.
Video
AdVideoAssetInfo.ad_video_asset_feature_control Nuovo campo Sono state aggiunte opzioni di controllo delle funzionalità per gli asset degli annunci video.
CampaignCriterionError Nuovo valore enum / errore È stato aggiunto il codice di errore INVALID_VIDEO_LINEUP_ID.
Metriche di udibilità di YouTube Nuove metriche Sono state aggiunte metriche di udibilità per gli annunci audio su YouTube, che indicano se un annuncio era udibile e su quante impressioni è stato possibile misurare l'udibilità.

Versioni principali e secondarie v22

La versione 22 dell'API Google Ads include le seguenti nuove funzionalità, aggiornamenti e modifiche che causano interruzioni.

v22.2 (24/06/2026)

Nella versione 22.2 dell'API Google Ads sono stati aggiunti i seguenti nuovi aggiornamenti e funzionalità. Le versioni secondarie come la v22.2 non contengono modifiche che provocano un errore.

Funzionalità e aggiornamenti Tipo Descrizione
Generale
Asset.synthetic_content_info
Ad.synthetic_content_info		 Nuovi campi Contengono attestazioni per i contenuti sintetici/generati con l'AI, suddivise in advertiser_attestation (dichiarazioni fornite direttamente dall'inserzionista) e system_attestation (attestazioni rilevate automaticamente o fornite dai sistemi di Google).

Per aiutarti a pianificare il lavoro di integrazione imminente per la v25, l'interfaccia per la modifica dei campi di attestazione dell'inserzionista viene introdotta in anticipo per la v22 e versioni successive. L'interfaccia è visibile in queste versioni, ma synthetic_content_info.advertiser_attestation.status e synthetic_content_info.advertiser_attestation.source rimarranno immutabili per queste versioni.

Se tenti una richiesta di modifica su uno di questi campi, verrà restituito uno di questi errori:

"The field attempted to be mutated is immutable" (Il campo che si è tentato di modificare è immutabile) o "Field cannot be set" (Impossibile impostare il campo).

Questi campi diventeranno completamente modificabili a partire dalla versione 25. Ti consigliamo di utilizzare l'interfaccia ora per creare e testare la logica interna in modo che il sistema sia pronto per le funzionalità di scrittura complete al lancio della versione 25.
Approvazioni da più parti Nuove funzionalità Aggiunta del supporto per le revisioni delle approvazioni da più parti (MPA):

v22.1 (25/02/2026)

La seguente nuova funzionalità è stata aggiunta nell'API Google Ads v22.1. Le versioni secondarie come la v22.1 non contengono modifiche che provocano errori.

Funzionalità e aggiornamenti Tipo Descrizione
Gestione account
Customer.contains_eu_political_advertising Nuovo campo Recupera lo stato della dichiarazione a livello di account relativa alla presenza o meno di pubblicità politica con targeting sull'UE e restituisce un EuPoliticalAdvertisingStatus.
Campagne
Campaign.missing_eu_political_advertising_declaration Nuovo campo Supporta l'interrogazione e il filtro delle campagne per le quali mancano dichiarazioni che indichino se contengono pubblicità politica rivolta all'UE.

v22 (2025-10-15)

Nella versione 22 dell'API Google Ads, che è una release principale, sono stati aggiunti i seguenti aggiornamenti, nuove funzionalità e modifiche che provocano un errore.

Per indicazioni, consulta l'articolo Eseguire l'upgrade all'ultima versione.

Modifiche che provocano un errore

Stato iniziale Nuovo stato Tipo di modifica Linee guida per l'implementazione
Demand Gen
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros Rinomina / correzione ortografica Rinomina i riferimenti in modo che utilizzino il nome del campo corretto.
Generale
Nessun limite di operazioni in AddBatchJobOperations Limite di 10.000 operazioni per richiesta Cambiamento comportamentale Assicurati che nessuna singola richiesta AddBatchJobOperations contenga più di 10.000 operazioni.
Dimensioni pagina limitate automaticamente a 1000 in ListBatchJobResultsRequest Restituisce l'errore INVALID_PAGE_SIZE Cambiamento comportamentale Assicurati che ListBatchJobResultsRequest.page_size sia impostato su 1000 o meno, poiché la richiesta di una dimensione della pagina più grande ora genererà un errore.
Performance Max
Etichette di rendimento delle risorse Nessuno Rimozione Il supporto delle etichette di rendimento degli asset e l'enumerazione delle etichette di rendimento associate sono stati rimossi per le campagne Performance Max. Aggiorna le integrazioni di conseguenza.
Campaign.url_expansion_opt_out Bandiera di FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION in AssetAutomationSetting Rimozione / sostituzione Utilizza l'impostazione di automazione degli asset di testo per l'espansione dell'URL finale. Il campo di disattivazione dell'espansione dell'URL a livello di campagna è stato rimosso.
Pianificazione
views trueview_views Rimozione / sostituzione Sostituisci i riferimenti a views con il nuovo campo trueview_views in ReachPlanService.
Video
average_cpv
video_view_rate
video_views
video_view_rate_in_feed
video_view_rate_in_stream
video_view_rate_shorts		 trueview_average_cpv
video_trueview_view_rate
video_trueview_views
video_trueview_view_rate_in_feed
video_trueview_view_rate_in_stream
video_trueview_view_rate_shorts		 Rinomina Aggiorna le stringhe di query e le integrazioni in modo da utilizzare i nuovi nomi delle metriche che rappresentano le visualizzazioni video TrueView.

Funzionalità e aggiornamenti (non distruttivi)

Funzionalità e aggiornamenti Tipo Descrizione
Asset
AssetFieldType.LANDING_PAGE_PREVIEW Nuovo valore enum Aggiunto come nuovo tipo di campo per gli asset immagine.
AssetGenerationService Nuovo servizio (beta) Consente di generare asset di testo e immagine utilizzando l'AI generativa:
  • GenerateText: genera testo in base a URL finale, prompt, parole chiave e così via.
  • GenerateImages: genera immagini in base all'URL finale, ai prompt o al ricontestualizzazione delle immagini prodotto.
  • Gli errori vengono restituiti con codici compresi tra AssetGenerationError.
Inizialmente disponibile solo per un numero limitato di partecipanti alla beta chiusa.
Campagne
AppCampaignBiddingStrategyGoalType Nuovi valori enum Sono stati aggiunti nuovi obiettivi per le campagne per app per incrementare le installazioni (ACi) da ottimizzare senza specificare un target:
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: da utilizzare con Massimizza le conversioni standard.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: da utilizzare con Massimizza il valore di conversione standard.
BiddingStrategyType Nuova funzionalità È stato aggiunto il supporto per il tipo di strategia di offerta quota fissa di share of voice.
Campaign.feed_types Nuovo campo Mostra i tipi di feed collegati a una campagna. Per le campagne Performance Max, può indicare il verticale dell'attività, ad esempio MERCHANT_CENTER_FEED per la vendita al dettaglio.
Targeting dei set condivisi Nuova funzionalità È consentito allegare set condivisi di parole chiave escluse a campagne multicanale (per le campagne per app) e locali.
Demand Gen
Offerte basate sul CPC target Nuova funzionalità È stata aggiunta la strategia di offerta per massimizzare i clic al CPC target: imposta il CPC target a livello di campagna utilizzando Campaign.target_cpc ed esegui l'override a livello di gruppo di annunci utilizzando AdGroup.target_cpc_micros.
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES Nuovo valore enum Se attivata per DemandGenMultiAssetAdInfo, questa opzione aggiunge elementi di design e incorpora asset di testo negli asset immagine per creare nuovi asset immagine con proporzioni diverse (attivata per impostazione predefinita).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS Nuovo valore enum Se attivata per DemandGenMultiAssetAdInfo, genera video utilizzando altri asset come immagini e testo, che possono poi essere utilizzati per creare nuove istanze di DemandGenVideoResponsiveAdInfo (funzionalità attivata per impostazione predefinita).
Generale
Fallback delle dimensioni della pagina ListBatchJobResultsRequest Modifica del comportamento Se page_size non è impostato o è 0, ora il valore predefinito è 1000 (in precedenza veniva restituito INVALID_PAGE_SIZE).
QuotaError Nuovo valore enum / errore È stato aggiunto PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED per indicare quando viene superato il limite di frequenza di attivazione del profilo pagamenti.
Performance Max
Impostazioni dell'automazione degli asset Nuovi valori enum Sono state aggiunte nuove opzioni di automazione degli asset PMax:
  • GENERATE_IMAGE_ENHANCEMENT: attiva la creazione automatica di immagini migliorate (ritaglio automatico). Abilitato per impostazione predefinita.
  • GENERATE_IMAGE_EXTRACTION: immagini provenienti dagli URL finali. Il valore predefinito è l'impostazione dell'estensione di immagine dinamica dell'account.
Segmenti dei report Performance Max Nuovi segmenti Sono stati aggiunti nuovi segmenti unici per le campagne Performance Max:
Pianificazione
Elenchi di dati dei partner CRM Nuova funzionalità / valore enum È stato aggiunto THIRD_PARTY_PARTNER_DATA alle origini dati CRM, insieme ai codici di errore di convalida del pubblico partner (ad esempio accettazione dei TdS, collegamento mancante e così via).
Metriche dei creator di live streaming Nuovo campo È stato aggiunto YouTubeMetrics.is_active_live_stream_creator, restituito dagli approfondimenti del creator per indicare se un creator ha pubblicato un live streaming negli ultimi 90 giorni.
Metadati dell'origine CRM pianificabile Nuovo messaggio È stato aggiunto PlannableUserListMetadata all'interno di PlannableUserList, restituito da ReachPlanService.ListPlannableUserLists, per mostrare i tipi di origini dati CRM.
Supporto per video e creator correlati in TrendInsight Nuovi campi È stato aggiunto il supporto per related_videos e related_creators su TrendInsight e per le proprietà di orologi in video_properties e publish_date.
Miglioramenti di InsightsFinder Nuova funzionalità GenerateInsightsFinderReport ora supporta parental_status, income_ranges e combinazioni di targeting AND/OR più complesse.
Report
Nuovi tipi di clic Nuovi valori enum Aggiunta di CLICK_TO_MESSAGE_THIRD_PARTY_CLICK e CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
Segmentazione AssetGroupAsset Supporto dei nuovi segmenti Ora AssetGroupAsset può essere segmentato per device, conversion_action, conversion_action_name e conversion_action_category.
RSA in AdGroupAdAssetView Supporto di nuove funzionalità / metriche AdGroupAdAssetView ora supporta completamente le metriche sul rendimento e sulle conversioni per RESPONSIVE_SEARCH_AD (in precedenza venivano restituite solo le impressioni).
Segmentazioni delle metriche dei cluster di query di esplorazione Supporto dei nuovi segmenti Le metriche clicks_unique_query_clusters, conversions_unique_query_clusters e impressions_unique_query_clusters ora possono essere segmentate in base ai campi data.
TargetingExpansionView Nuova risorsa per la creazione di report È stato aggiunto TargetingExpansionView per segnalare le metriche relative alle espansioni rispetto al targeting manuale, ad esempio l'espansione senza parole chiave per le campagne AI Max per la rete di ricerca.
Shopping
Correzione dell'ambito Shopping Correzione di bug È stato corretto l'ambito delle metriche per campagne e gruppi di annunci nella risorsa ShoppingProduct.
Obiettivi unificati
Obiettivi di fidelizzazione Nuova funzionalità È stato aggiunto il supporto per gli obiettivi di fidelizzazione dei clienti per ottimizzare il coinvolgimento dei clienti esistenti (ad es. utilizzando target_option con TARGET_SPECIFIC o TARGET_ALL).
Video
Metriche sul tempo di visualizzazione dei video Nuovi campi Sono state aggiunte le metriche relative alla durata del tempo di visualizzazione: video_watch_time_duration_millis (durata totale) e average_video_watch_time_duration_millis (durata media per impressione).

Versioni principali e secondarie v21

L'API Google Ads v21 include le seguenti nuove funzionalità, aggiornamenti e modifiche che causano interruzioni.

v21.2 (24/06/2026)

Nella versione 21.2 dell'API Google Ads sono stati aggiunti i seguenti nuovi aggiornamenti e funzionalità. Le versioni secondarie come la v21.2 non contengono modifiche che provocano errori.

Funzionalità e aggiornamenti Tipo Descrizione
Generale
Approvazioni da più parti Nuove funzionalità Aggiunta del supporto per le revisioni delle approvazioni da più parti (MPA):

v21.1 (25/02/2026)

Nella versione 21.1 dell'API Google Ads sono stati aggiunti i seguenti nuovi aggiornamenti e funzionalità. Le versioni secondarie come la v21.1 non contengono modifiche che provocano errori.

Funzionalità e aggiornamenti Tipo Descrizione
Gestione account
Customer.contains_eu_political_advertising Nuovo campo Recupera lo stato della dichiarazione a livello di account relativa alla presenza o meno di pubblicità politica con targeting sull'UE e restituisce un EuPoliticalAdvertisingStatusEnum.
Campagne
Campaign.missing_eu_political_advertising_declaration Nuovo campo Supporta l'interrogazione e il filtro delle campagne per le quali mancano dichiarazioni che indichino se contengono pubblicità politica rivolta all'UE.

v21 (2025-08-06)

Nella versione 21 dell'API Google Ads, che è una release principale, sono stati aggiunti i seguenti aggiornamenti, nuove funzionalità e modifiche che causano interruzioni.

Per indicazioni, consulta l'articolo Eseguire l'upgrade all'ultima versione.

Modifiche che provocano un errore

Stato iniziale Nuovo stato Tipo di modifica Linee guida per l'implementazione
Campagne
Restituisce CriterionError.INVALID_LISTING_GROUP_HIERARCHY Restituisce CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION Modifica del codice di errore Per le richieste con un errore parziale abilitato, gestisci il nuovo codice di errore anziché il codice di errore della gerarchia originale.
Conversioni
Accesso alla modalità debug_enabled in ConversionUploadService Nessuno Rimozione Il campo debug_enabled viene rimosso. Aggiorna il codice che lo fa riferimento in modo da non impostare o interrogare questo parametro.
Modifiche alla pubblicità politica nell'UE
Autodichiarazioni facoltative della campagna per la pubblicità politica nell'UE Campo contains_eu_political_advertising obbligatorio per le nuove campagne Regola di convalida / cambiamento comportamentale Se questo campo non è impostato, le chiamate API per creare nuove campagne non andranno a buon fine e verrà visualizzato l'errore FieldError.REQUIRED. A partire dal 22 settembre 2025, le campagne dichiarate come CONTAINS_EU_POLITICAL_ADVERTISING non verranno più pubblicate nell'UE.
Criteri modificabili senza autodichiarazione Aggiornamenti non riusciti con CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Regola di convalida / cambiamento comportamentale Imposta lo stato di autodichiarazione prima di tentare di creare o aggiornare i criteri di targeting per prossimità, località o gruppo di località a livello di campagna o gruppo di annunci per le campagne esistenti.
Esperimenti senza requisiti di autodichiarazione Aggiornamenti non riusciti con ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Regola di convalida / cambiamento comportamentale Assicurati che le autodichiarazioni siano state completate nelle campagne dell'esperimento.
Performance Max
brand_guidelines_enabled è impostato su false per impostazione predefinita Il valore predefinito è true Cambiamento comportamentale Per le nuove campagne Performance Max, le linee guida per il brand sono attivate per impostazione predefinita. Imposta esplicitamente il campo su false se devono essere disattivati.
Pianificazione
Tipo di argomento di input originale per AudienceInsightsService.GenerateTargetingSuggestionMetrics Input di tipo InsightsAudience Modifica del tipo Aggiorna le implementazioni per trasmettere il nuovo tipo di input che supporta una combinazione AND-OR degli interessi degli utenti, consentendo metriche di copertura potenziali per le definizioni dei segmenti di pubblico personalizzati.

Funzionalità e aggiornamenti (non distruttivi)

Funzionalità e aggiornamenti Tipo Descrizione
AI Max per le campagne sulla rete di ricerca
ai_max_setting.enable_ai_max in Campaign Nuovo campo Consente ad AI Max di espandere la corrispondenza dei termini di ricerca (rispettando l'automazione degli asset di testo e gli elenchi di brand precedenti fino alla disattivazione). Il campo Campaign.ai_max_setting.bundling_required indica se AI Max deve essere attivato per rispettare/modificare queste impostazioni, mentre AdGroup.ai_max_ad_group_setting.disable_search_term_matching può disattivare la corrispondenza a livello di gruppo di annunci. Consulta Aumenta il rendimento con AI Max per campagne sulla rete di ricerca.
CampaignError.AI_MAX_MUST_BE_ENABLED Nuovo valore enum / errore Generata quando viene attivata l'automazione degli asset di testo per l'espansione dell'URL nelle campagne sulla rete di ricerca senza abilitare AI Max.
Targeting a livello di gruppo di annunci Nuova funzionalità È stato aggiunto il supporto in AI Max per le campagne sulla rete di ricerca per elenchi di brand, località e pagine web (regole per gli URL) a livello di gruppo di annunci.
ai_max_search_term_ad_combination_view Nuova risorsa per la creazione di report Report sul rendimento delle combinazioni di termini di ricerca, titoli e pagine di destinazione.
Segmento search_term_match_type Nuovo valore enum È stato aggiunto AI_MAX come opzione per il tipo di corrispondenza dei termini di ricerca.
Asset
PromotionAsset Nuovi campi Sono state aggiunte le opzioni terms_and_conditions_text, terms_and_conditions_uri e oneof promotion_trigger (promotion_barcode_info, promotion_qr_code_info). Consulta Informazioni sugli asset di promozione.
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION Nuovo valore enum Aggiunto a AssetAutomationType per controllare la generazione automatica di testo e pagine di destinazione dagli URL finali nelle campagne sulla rete di ricerca.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset Nuovo servizio / metodo Consente di rimuovere dalle campagne gli asset di espansione dell'URL finale creati automaticamente.
ServedAssetFieldType.DESCRIPTION_PREFIX Nuovo valore enum Aggiunta per correggere un problema di generazione di report in cui il tipo veniva restituito come UNKNOWN in ad_group_ad_asset_combination_view.
Campagne
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING Nuovo valore enum Restituito quando le campagne con limitazioni geografiche non hanno un targeting per località (che ora genera LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN se il targeting è al di fuori dell'area consentita).
Integrazione dell'analisi dell'app di terze parti Nuovi campi È stato aggiunto il supporto per VideoCustomer.third_party_integration_partners e Campaign.third_party_integration_partners. Consulta Monitorare le conversioni da app con analisi di terze parti.
Campaign.advertising_partner_ids Supporto per nuovi campi Ora il campo può essere impostato per le campagne esistenti (rimane immutabile dopo l'impostazione).
Posizionamenti esclusi a livello di account amministratore Nuova funzionalità Consente le esclusioni di elenchi di posizionamenti in tutti gli account inserzionista individuali utilizzando CustomerNegativeCriterion.
Configurazioni della tolleranza nelle strategie ROAS target Nuovi campi È stato aggiunto il supporto per TargetRoas.target_roas_tolerance_percent_millis (per le strategie di portafoglio delle campagne sulla rete di ricerca) in MaximizeConversionValue e TargetRoas.
LocationInterestView Nuova risorsa per la creazione di report Riepiloga il rendimento dei criteri di interesse per le località del gruppo di annunci.
Conversioni
Segmento conversion_attribution_event_type Nuovo valore enum È stato aggiunto ENGAGED_VIEW alle opzioni del tipo di attribuzione delle conversioni.
Demand Gen
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM Nuovo valore enum / errore Aggiunta in preparazione all'applicazione dei budget giornalieri minimi per le campagne Demand Gen. I dettagli vengono esposti utilizzando budgetDailyMinimumErrorDetails.
Performance Max
campaign_search_term_view Nuova risorsa per la creazione di report Aggrega le metriche dei termini di ricerca a livello di campagna, consentendo l'analisi e la generazione di report sui termini di ricerca per Performance Max.
Pianificazione
ReachPlanService.ListPlannableUserInterests Nuovo metodo Consente di scoprire affinità pianificabili e interessi in-market per generateReachForecast.
AdditionalApplicationInfo Nuovo campo Aggiunto come input facoltativo in ReachPlanService.ListPlannableUserLists.
Elenco degli attributi di Audience Insights Nuova funzionalità AudienceInsightsService.ListAudienceInsightsAttributes ora recupera gli elenchi di utenti proprietari disponibili.
Targeting degli elenchi CRM di AudienceCompositionInsights Nuova funzionalità AudienceInsightsService.GenerateAudienceCompositionInsights ora restituisce i dettagli dell'indice dell'elenco utenti per le dimensioni AudienceInsightsDimension: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST e IN_MARKET_USER_INTEREST.
Quota di pubblico TrendInsightMetrics Nuovo campo Rappresenta la quota di un segmento di pubblico per una tendenza.
Categorie KnowledgeGraphAttributeMetadata Nuovi campi Filtra gli attributi Knowledge Graph in base alle categorie corrispondenti.
Report
Metriche sulle visualizzazioni degli asset Nuove funzionalità / metriche Sono state aggiunte diverse nuove metriche a AssetGroupAsset, ChannelAggregateAssetView e CampaignAggregateAssetView. Inoltre, le campagne Performance Max ora riportano i valori reali per impressions.
Estensioni dei selettori Nuova funzionalità AssetSet e CampaignAssetSet sono ora interrogabili insieme all'interno di ChangeStatus.
search_term_targeting_status Nuovo segmento Segmento selezionabile nella visualizzazione dei termini di ricerca della campagna.
final_url_expansion_asset_view Nuova risorsa per la creazione di report Mostra i dettagli sul rendimento degli asset di espansione dell'URL finale.
Aggiustamenti del valore AssetGroup Nuovi campi È stato aggiunto il supporto per le metriche value_adjustment e all_value_adjustment nel report AssetGroup.
landing_page_source Nuovo segmento Fornisce un segmento di origine della pagina di destinazione in landing_page_view.
search_term_match_source Nuovo segmento Segmento selezionabile nelle visualizzazioni Termini di ricerca e Termini di ricerca della campagna.
match_type Nuovo segmento Chiave di segmento selezionabile nella visualizzazione delle parole chiave.
Report sui cluster di intenti di query unici Nuovi campi Sono stati aggiunti clicks_unique_query_clusters, conversions_unique_query_clusters e impressions_unique_query_clusters per generare report sui cluster di intent di query unici.
ClickType.VEHICLE_ASSETS Nuovo valore enum Monitora e segnala i clic correlati in modo specifico ai formati degli annunci di veicoli nel report click_view.
Esplorazione di Smart Bidding
configurazioni di tolleranza nelle strategie di ricerca Nuovi campi / impostazioni Consente di attivare l'esplorazione Smart Bidding nelle campagne sulla rete di ricerca impostando target_roas_tolerance_percent_millis tra 10.000 (10%) e 30.000 (30%) inclusi (Massimizza le conversioni richiede l'impostazione target_roas). Consulta il nostro post del blog sull'esplorazione Smart Bidding e l'articolo del Centro assistenza.
compatibilità con i report sulla diversità Nuova funzionalità Ora è supportata la reportistica sulla diversità aggregata per le seguenti metriche per i cluster di intent di query unici. Una visualizzazione segmentata nel tempo è disponibile nella UI di Google Ads:
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
Video
YouTubeVideoListAsset Nuova risorsa / campo Consente di stabilire collegamenti tra le campagne e gli asset elenchi video utilizzando Asset.youtube_video_list_asset. Vedi Utilizzo dei video correlati.
Estensioni dei metadati degli approfondimenti Nuovi campi Sono stati aggiunti nuovi metadati a YouTubeChannelInsights e YouTubeVideoAttributeMetadata.
Tipi di clic interattivi Nuovi valori enum Tipi di clic aggiunti: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK e PRODUCT_ASSETS.
VideoAdInventoryControl.allow_non_skippable_in_stream Nuovo campo Consente agli annunci video adattabili di essere pubblicati come annunci in-stream non ignorabili per le campagne che combinano formati ignorabili e non ignorabili.
Impostazioni della sequenza di video Nuovi campi Sono state aggiunte configurazioni di sequenziamento di sola lettura: Campaign.VideoCampaignSettings.video_ad_sequence e VideoAdSequenceStepSetting. Consulta la sezione Informazioni sulle sequenze di annunci video.
Targeting della selezione di video Nuovo tipo di criterio / campo È stato aggiunto il tipo di criterio VIDEO_LINEUP e il campo corrispondente in CampaignCriterion e AdGroupCriterion. Questa funzionalità è disponibile solo per gli account nella lista consentita.
Visualizzazioni dei posizionamenti per idoneità dei contenuti Nuove risorse per la creazione di report È stato aggiunto un report sull'idoneità dei contenuti sia a livello di dettaglio (detail_content_suitability_placement_view) che di gruppo (group_content_suitability_placement_view). Consulta la sezione Informazioni sul report "Idoneità dei contenuti".

Note di rilascio archiviate

Consulta la sezione Versioni ritirate per le note di rilascio archiviate.