Note di rilascio

Consulta la sezione Ritiro delle funzionalità per un elenco aggiornato dei ritiri delle funzionalità attuali e pianificati.

Versioni principali e secondarie v25

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

v25.2 (23/09/2026)

Nella versione 25.2 dell'API Google Ads sono state aggiunte le seguenti nuove funzionalità e aggiornamenti. Le versioni secondarie come la v25.2 non contengono modifiche che provocano un errore.

Funzionalità e aggiornamenti Tipo Descrizione
Asset
Opzioni URL per AssetGroup Nuovi campi È stato aggiunto il supporto per le opzioni URL su AssetGroup, consentendo agli inserzionisti di specificare modelli di monitoraggio, parametri personalizzati e suffissi URL finali a livello di gruppo di asset:
Campagne
Informazioni sulla scansione automatica dei video Nuovi campi ed enumerazioni È stato aggiunto AutomatedVideoCrawlSetting a Campaign.AssetAutomationSetting, insieme a AssetAutomationType.AUTOMATED_VIDEO_CRAWL, per consentirti di specificare le impostazioni di scansione automatica dei video per una campagna Performance Max. AutomatedVideoCrawlSetting.automated_video_crawl_infos contiene un elenco di voci AutomatedVideoCrawlInfo, ognuna delle quali configura una url, un source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL o YOUTUBE) e lo stato di attivazione enabled.
Errori del moltiplicatore del valore dell'ottimizzazione del ciclo di vita dei clienti Nuovi valori enum ed errori Sono stati aggiunti nuovi motivi di errore di convalida durante la configurazione dei moltiplicatori di valore (value_multiplier e high_lifetime_value_multiplier) per l'ottimizzazione del ciclo di vita del cliente:
SmartCampaignSettingService.GeneratePMaxDraftCampaign Nuova funzionalità È stato aggiunto SmartCampaignSettingService.GeneratePMaxDraftCampaign per supportare la generazione di una bozza di campagna Performance Max da una campagna intelligente esistente, inizializzata con lo stato CampaignStatus.PAUSED e lo stato di creazione CampaignCreationStatus.INCOMPLETE (vedi Convertire le campagne intelligenti in campagne Performance Max):
Conversioni
Impressioni annuncio Firebase Nuovi tipi e categorie di azioni di conversione Tipi di azioni di conversione FIREBASE_ANDROID_APP_AD_IMPRESSION e FIREBASE_IOS_APP_AD_IMPRESSION, che ti consentono di recuperare e modificare queste azioni di conversione. È stata inoltre esposta la categoria IN_APP_AD_REVENUE in ConversionActionCategory per monitorare le entrate da monetizzazione degli annunci in-app.
Generale
BusinessProfileLocationSyncError Nuovo enum ed errori Sono stati aggiunti i motivi degli errori di sincronizzazione delle sedi del profilo dell'attività durante la sincronizzazione delle sedi in un AssetSet di tipo LOCATION_SYNC. Anziché restituire un errore generico UNKNOWN, l'API ora restituisce BusinessProfileLocationSyncError con motivi specifici (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED e NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
Pianificazione
Metriche percentile BenchmarksService.GenerateBenchmarksMetrics Nuove funzionalità

Aggiornamento di BenchmarksService.GenerateBenchmarksMetrics per fornire metriche che rappresentano la posizione competitiva del cliente rispetto ad altri inserzionisti nel formato del livello percentile. Le metriche vengono restituite in PercentileMetrics nel nuovo campo CustomerMetrics.percentile_metrics (sia in GenerateBenchmarksMetricsResponse.customer_metrics che in BreakdownMetrics.customer_metrics) e rappresentate utilizzando BenchmarksCustomerPercentileTier.

CustomerMetrics.percentile_metrics viene compilato solo quando sono soddisfatte entrambe le seguenti condizioni in GenerateBenchmarksMetricsRequest:

È stato aggiunto il supporto per le metriche percentile per le date dei trimestri aperti all'interno di ListBenchmarksAvailableDatesResponse.supported_dates (restituite da BenchmarksService.ListBenchmarksAvailableDates). Mentre le metriche aggregate dei clienti (CustomerMetrics.aggregate_metrics), le metriche del tasso dei clienti (CustomerMetrics.average_rate_metrics) e le metriche percentile dei clienti (CustomerMetrics.percentile_metrics) sono supportate in tutte le date in supported_dates (inclusi i trimestri aperti), le metriche della quota dei clienti (CustomerMetrics.share_metrics) e le metriche del tasso dell'origine dei benchmark (average_benchmarks_metrics, ad esempio average_cpm degli annunci "/Abbigliamento/Vestiti") non sono supportate per i trimestri aperti e vengono omesse dalla risposta, a meno che date_range richiesto non rientri nell'intervallo più ristretto di ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics.

È stato aggiunto un errore personalizzato BenchmarksError.NO_METRICS_FOUND che indica che non sono state trovate metriche per la combinazione di input selezionata per migliorare l'usabilità.
Handle dei canali YouTube per le statistiche dei creator Nuova funzionalità È stato aggiornato ContentCreatorInsightsService.GenerateCreatorInsights per supportare la ricerca tramite gli handle dei canali YouTube utilizzando YouTubeChannels.youtube_channel_handles (gli handle dei canali validi devono iniziare con @, ad esempio @channel_handle). Questa opzione è simile alla ricerca per ID canale YouTube. La risposta contiene approfondimenti sui creator di YouTube richiesti.
Consigli
Consigli sulle offerte basate sul CPA e sul ROAS Nuovi suggerimenti Sono stati aggiunti Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) e Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW), insieme a ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low e ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, per supportare l'aumento del CPA target o la riduzione del ROAS target quando le offerte sono troppo basse per consentire alle campagne sulla rete di ricerca di partecipare alle aste:
Report
Segmenti di dimensioni degli itinerari dell'hotel Nuovi segmenti Sono stati aggiunti i seguenti segmenti di dimensioni dell'itinerario di prenotazione di hotel e viaggi a Segments (selezionabili con campaign, ad_group e customer):
Metriche degli annunci verticali Nuove metriche Sono state aggiunte le seguenti metriche per i report sugli annunci verticali per hotel e viaggi a Metrics (selezionabili con campaign, ad_group e customer):
Segmenti degli annunci verticali Nuovi segmenti Sono stati aggiunti i seguenti segmenti per i report sugli annunci verticali per hotel e viaggi a Segments (selezionabili con campaign, ad_group e customer):

v25.1 (19/08/2026)

Nella versione 25.1 dell'API Google Ads sono state aggiunte le seguenti nuove funzionalità e aggiornamenti. Le versioni secondarie come la v25.1 non contengono modifiche che provocano un errore.

Funzionalità e aggiornamenti Tipo Descrizione
Asset
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER		 Nuovi valori enum È stato aggiunto il supporto per gli asset disclaimer di testo.
Campagne
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time		 Nuovi campi Monitora l'imminente migrazione automatica ad AI Max.
Conversioni
Misurazioni del brand lift Nuove funzionalità È stato aggiunto il supporto per le misurazioni del brand lift con i seguenti aggiornamenti:
Misurazioni del conversion lift Nuove funzionalità È stato aggiunto il supporto per le misurazioni del conversion lift con i seguenti aggiornamenti:
  • È stata aggiunta una nuova risorsa di sola lettura LiftMeasurementConfig che rappresenta uno studio sull'impatto.
  • Sono stati aggiunti nuovi segmenti selezionabili per segmentare e filtrare i risultati dell'impatto.
  • Sono state aggiunte 24 nuove metriche del conversion lift e metriche del punteggio del vincitore che supportano l'analisi statistica dettagliata del rendimento del lift.
  • È stato aggiunto il supporto per recuperare i dettagli della campagna e gli obiettivi di conversione.
  • È stato aggiunto un nuovo campo facoltativo Experiment.lift_measurement_config.
  • Aggiunta dell'enum ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight Nuova risorsa Una nuova risorsa di sola lettura che rappresenta i dettagli del volo per una configurazione della misurazione dell'impatto, incluse le date di inizio e fine del volo misurato (start_date e end_date).
Generale
SmartCampaignError Nuovi valori enum Sono stati aggiunti nuovi codici di errore specifici per i vincoli di generazione di Performance Max:
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION Nuovo valore enum / errore Restituito quando un progetto Google Cloud con livello di accesso TEST tenta di effettuare richieste a un account non di test.
Pianificazione
Insight sul sentiment del brand Nuove funzionalità È stato aggiunto il supporto per gli approfondimenti sul sentiment del brand in ContentCreatorInsightsService:
Miglioramenti di BenchmarksService Nuove funzionalità È stato aggiunto il supporto per le categorie come filtri per definire l'ambito di un'analisi dei benchmark. Sono supportate anche metriche aggiuntive fondamentali per l'attività:
Targeting per stato parentale Nuova funzionalità È stato aggiunto il supporto per il targeting in base allo stato parentale nella pianificazione della copertura. È stato aggiunto il nuovo campo parental_statuses a Targeting per il servizio ReachPlanService.GenerateReachForecast e parental_statuses a PlannableTargeting per il servizio ReachPlanService.ListPlannableProducts.
Consigli
Recommendation.campaign_specific_app_goal_recommendation Nuovo consiglio Suggerisce di aggiungere un obiettivo di conversione da app specifico per la campagna. La nuova risorsa EffectiveAutomaticGoal viene utilizzata per rappresentare gli obiettivi attuali all'interno di questo consiglio.
Report
Metrics.original_conversion_value Nuovo campo Rappresenta il valore di conversione originale delle conversioni per cui è possibile fare offerte. Si tratta del valore non modificato delle conversioni prima dell'applicazione di eventuali aggiustamenti delle regole per i valori, ad esempio le regole per i valori di conversione o gli aggiustamenti degli obiettivi basati sul ciclo di vita.
Statistiche sull'abbonamento al programma fedeltà Nuove funzionalità È stato aggiunto il supporto per la segmentazione delle statistiche in base allo stato del programma fedeltà degli utenti ed è stata aggiunta la dimensione principale dell'iscrizione al programma fedeltà per le regole per i valori di conversione:
  • È stato aggiunto il segmento Segments.loyalty_membership per supportare la segmentazione delle metriche dei report in base al livello del programma fedeltà dell'utente che ha generato la conversione.
  • È stata aggiunta la dimensione principale LOYALTY_MEMBERSHIP per identificare quando una condizione di iscrizione al programma fedeltà è stata soddisfatta per una regola per i valori di conversione.
Targeting
vertical_ads_item_bid Nuovo tipo di criterio È stato aggiunto il nuovo tipo di criterio vertical_ads_item_bid a AdGroupCriterion.criterion.

v25 (22/07/2026)

Le seguenti nuove funzionalità, aggiornamenti e modifiche che causano interruzioni sono stati aggiunti all'API Google Ads v25, che è una release principale.

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

Modifiche che provocano un errore

Stato iniziale Nuovo stato Tipo di modifica Linee guida per l'implementazione
Campagne
Campi autonomi additional_value e additional_high_lifetime_value in CustomerLifecycleOptimizationValueSettings Parte di value_adjustment e high_lifetime_value_adjustment, rispettivamente, insieme ai nuovi campi value_multiplier e high_lifetime_value_multiplier Modifica strutturale Aggiorna i riferimenti a questi campi perché ora fanno parte di oneof.
Risorse legacy CustomerLifecycleGoal e CampaignLifecycleGoal, i relativi servizi CustomerLifecycleGoalService e CampaignLifecycleGoalService e impostazioni/enumerazioni legacy (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) Nessuno Rimozione Utilizza lo schema degli obiettivi unificati rinnovato:
Generale
Campi enum nidificati nei messaggi di richiesta di servizio e risposta del servizio incentivi:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 Campi enum autonomi: Rinomina / rimozione Utilizza i nuovi campi enum autonomi anziché i campi type legacy.
Campi facoltativi selected_incentive_id e customer_id in ApplyIncentiveRequest Campi obbligatori comportamento diverso Assicurati di fornire entrambi i campi quando chiami ApplyIncentive.
Il campo dell'indirizzo email del consumatore ContactDetails.email nella risorsa LocalServicesLead Nessuno Rimozione Rimuovi i riferimenti a questo campo perché non è più supportato.
Campo facoltativo allowed_domain in AdvertisingPartnerLinkInvitationProperties Campo obbligatorio quando chiami CreateProductLinkInvitation per un partner pubblicitario comportamento diverso Assicurati di fornire allowed_domain quando crei un invito al collegamento dei prodotti per un partner pubblicitario.
Pianificazione
Il campo search_brand in GenerateCreatorInsightsRequest Nessuno Rimozione Utilizza invece search_topics.
Il campo plannable_location_id in Targeting e il campo cookie_frequency_cap in GenerateReachForecastRequest Nessuno Rimozione Passa all'utilizzo di plannable_location_ids e cookie_frequency_cap_setting.
Report
Campo customer_metrics in GenerateBenchmarksMetricsResponse e BreakdownMetrics di tipo Metrics Campo di tipo CustomerMetrics Modifica del tipo / comportamento diverso Aggiorna le integrazioni per utilizzare il nuovo tipo CustomerMetrics, che contiene solo metriche che rappresentano il rendimento dell'annuncio del cliente.

Funzionalità e aggiornamenti (non distruttivi)

Funzionalità e aggiornamenti Tipo Descrizione
Annunci
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS Nuovo valore / comportamento enum Disponibile per DemandGenMultiAssetAds. Se abilitata, genera immagini animate utilizzando immagini non animate come input. A partire da questa versione dell'API, i nuovi DemandGenMultiAssetAds vengono attivati per impostazione predefinita.
Modificabilità delle informazioni sui contenuti sintetici Modifica del comportamento Asset.synthetic_content_info e Ad.synthetic_content_info ora sono completamente modificabili nelle versioni 25, 24 e 23.
Campagne
Obiettivo di fidelizzazione Nuove funzionalità / impostazioni È stato aggiunto il supporto per l'obiettivo di fidelizzazione, che consente agli inserzionisti di ottimizzare le campagne per fidelizzare i membri del programma fedeltà.
Obiettivo di acquisizione di nuovi clienti Nuove funzionalità / impostazioni Supporto aggiornato dell'obiettivo di acquisizione di nuovi clienti nell'API Google Ads per riflettere lo schema degli obiettivi unificati rinnovato:
Conversioni
Attribuzione delle conversioni di terze parti di YouTube Nuovi campi È stato aggiunto il supporto per la verifica dell'attribuzione delle conversioni di YouTube utilizzando partner terzi: Consulta l'articolo del Centro assistenza per saperne di più.
Generale
ContactDetails.phone_number_extension Nuovo campo Aggiunta alla risorsa LocalServicesLead.
IncentiveError Nuovi valori enum ed errori Sono stati aggiunti nuovi codici di errore specifici per gli errori di utilizzo degli incentivi:
Pianificazione
Dettagli del canale YouTube negli approfondimenti sulle tendenze Nuovi campi È stato aggiunto il supporto per ulteriori dettagli sui canali YouTube dei video correlati durante la ricerca di approfondimenti sulle tendenze. Sono stati aggiunti i nuovi campi channel_id, channel_name e channel_url a YouTubeVideoAttributeMetadata.
YouTubeChannelInsights.data_sharing_consent_given Nuovo campo Aggiunto a YouTubeChannelInsights. Ciò vale se un creator ha acconsentito alla condivisione di dati non pubblici. In questo caso, vengono compilati i seguenti campi:
Report
ad_sub_format_type Nuovo segmento Fornisce una suddivisione degli annunci in-stream non ignorabili di YouTube in base alla durata: Questo segmento deve essere sempre selezionato insieme a ad_format_type. È selezionabile con AdGroup, AdGroupAd, Campaign, Customer, Video e VideoEnhancement.
Metriche social specifiche per i video Nuovi campi / metriche Sono state aggiunte metriche social specifiche per i video per aiutare gli inserzionisti a monitorare il coinvolgimento degli utenti (commenti, Mi piace e condivisioni) per gli annunci di Shorts su YouTube: Sono disponibili in AdGroup, AdGroupAd, Asset, Campaign, Customer e Video.

Versioni principali e secondarie v24

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

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 Aggiunta per supportare 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 Contengono attestazioni per contenuti sintetici/generati con l'AI, suddivise in advertiser_attestation (dichiarazioni fornite direttamente dall'inserzionista) e system_attestation (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 versione 25, l'interfaccia per la modifica dei campi di attestazione dell'inserzionista viene introdotta in anticipo per la versione 22 e 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 tuo sistema sia pronto per le funzionalità di scrittura complete al lancio della versione 25.
Autorizzazione da più parti Nuove funzionalità È stato aggiunto il supporto per le revisioni con 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, tra cui 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 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 residenti nel paese scelto che hanno acconsentito alla condivisione dei dati sulla posizione.
GenerateTrendingInsightsRequest.sub_country_locations Nuovo campo Aggiunta a ContentCreatorInsightsService.GenerateTrendingInsights, consentendo le ricerche di approfondimenti sulle tendenze utilizzando la località del paese e le località secondarie.
Report
PerformanceMaxPlacementView Estensione dei segmenti Reso segmentabile da ad_network_type.
Shopping
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads Nuovo campo Se è true, 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 state aggiunte le seguenti nuove funzionalità e aggiornamenti. 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 della configurazione per gli esperimenti YOUTUBE_CUSTOM esistenti costituiti da campagne video.
ExperimentArm.asset_testing_info
ExperimentArm.asset_groups
ExperimentArm.performance_max_experiment_arm_info		 Nuovi campi Espone 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 e 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 stime della differenza assoluta Conversions 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 per la visibilità di terze parti.
DataLink.youtube_video.channel_id Nuovo campo Mostra l'ID canale YouTube associato al collegamento dei dati.

v24 (22/04/2026)

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

Per indicazioni, consulta la sezione 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 comportamento diverso 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 comportamento diverso 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à alla 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 di previsione / piano 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 Segmento ad_sub_network_type rimosso 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 comportamento diverso 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 / comportamento diverso I codici di errore restituiti per i gruppi di asset vengono modificati in modo che corrispondano agli 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
Mutabilità 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 degli asset dei feed di 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 per 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 la descrizione del prodotto pianificabile, l'obiettivo di marketing, il modello di costo e il metodo di acquisto a ProductCoreAttributes in ListPlannableProductsResponse.
Report
CartDataSalesView Nuova risorsa per la generazione 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 vengono ottimizzate) 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 delle note non sono supportati.
Filtro dei prodotti basato sui tag Nuova funzionalità È stato introdotto il filtraggio utilizzando dinamicamente 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 nuovi aggiornamenti e funzionalità. Le versioni secondarie come la v23.3 non contengono modifiche che provocano errori.

Funzionalità e aggiornamenti Tipo Descrizione
Generale
Asset.synthetic_content_info
Ad.synthetic_content_info		 Nuovi campi Contenere attestazioni per 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 versione 25, l'interfaccia per la modifica dei campi di attestazione dell'inserzionista viene introdotta in anticipo per la versione 22 e 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 tuo 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 errori.

Funzionalità e aggiornamenti Tipo Descrizione
Asset
VideoEnhancement Nuova risorsa Contiene informazioni sugli annunci video specifiche per il miglioramento, ad esempio se sono generati da Google o forniti 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 di 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 È stata aggiunta l'opzione della piattaforma IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS.
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 state aggiunte le seguenti nuove funzionalità e aggiornamenti. 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 Aggiunto alle risorse ProductLinkInvitation e ProductLink. Il partner pubblicitario potrà fare pubblicità 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 creati 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 relative alla presenza o meno di 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 Indeterminato 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 per data 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 a 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 causano interruzioni.

Per indicazioni, consulta la sezione 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 comportamento diverso 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 con la data vengono rimossi.
Demand Gen
DemandGenMultiAssetAdInfo.lead_form_only Nessuno Rimozione Il campo lead_form_only è stato rimosso. Aggiorna i riferimenti nel codice.
Report
Aggrega le metriche e l'enumerazione delle etichette di rendimento delle risorse 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
asset_group visualizzazione Nuovi campi Sono state aggiunte le seguenti metriche: metrics.engagements, metrics.engagement_rate e metrics.average_cpe.
asset_group_asset visualizzazione 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 in 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 messaggistica inviata all'attività aggiornati:
Fatturazione
InvoiceService.ListInvoices Nuove opzioni Ora può restituire dettagli più granulari in Invoice, inclusa 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 stati aggiunti enum helper per le unità di misura e gli oneri normativi.
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 il tuo (CYO):

Per facilitare la gestione programmatica più granulare degli errori, nelle versioni future aggiungeremo ulteriori codici di errore a IncentivesService. Ti consigliamo di monitorare gli annunci e le note di rilascio imminenti 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 della piattaforma (ad es. Gmail, Shorts). Supportato solo per le campagne Demand Gen.
LanguageDistribution Nuovo campo / tipo Aggiunto 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 segmento di 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 per 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 i 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 viaggi.
Integrazione del feed di dati pubblicitari verticali Nuova funzionalità Ora puoi collegare un feed di dati pubblicitari verticali a una campagna sulla rete di ricerca che utilizza AI Max per mostrare annunci di viaggi 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. Segmentazione dei report in base a AdFormatType e alle 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 in quante impressioni è stato possibile misurare l'udibilità.

Versioni principali e secondarie v22

L'API Google Ads v22 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 errori.

Funzionalità e aggiornamenti Tipo Descrizione
Generale
Asset.synthetic_content_info
Ad.synthetic_content_info		 Nuovi campi Contenere attestazioni per 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 versione 25, l'interfaccia per la modifica dei campi di attestazione dell'inserzionista viene introdotta in anticipo per la versione 22 e 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 tuo 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)

Nella versione 22.1 dell'API Google Ads è stata aggiunta la seguente nuova funzionalità. 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 relative alla presenza o meno di pubblicità politica rivolta all'UE.

v22 (15/10/2025)

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

Per indicazioni, consulta la sezione 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 comportamento diverso Assicurati che nessuna singola richiesta AddBatchJobOperations contenga più di 10.000 operazioni.
Dimensione pagina limitata a 1000 in ListBatchJobResultsRequest Errore di restituzione INVALID_PAGE_SIZE comportamento diverso Assicurati che ListBatchJobResultsRequest.page_size sia impostato su 1000 o meno, poiché la richiesta di una dimensione della pagina maggiore ora genererà un errore.
Performance Max
Etichette di rendimento degli asset 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 Flag 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 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 versione 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: utilizza questa strategia 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à È stato consentito di 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 e sostituiscilo 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 (attivate per impostazione predefinita).
Generale
Fallback delle dimensioni della pagina ListBatchJobResultsRequest Modifica del comportamento Se page_size non è impostato o è 0, ora il valore predefinito è il massimo di 1000 (in precedenza restituiva 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 di 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 dinamica con immagini dell'account.
Segmenti dei report PMax 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 segmento di 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 CLICK_TO_MESSAGE_THIRD_PARTY_CLICK e CLICK_TO_MESSAGE_LANDING_PAGE_CLICK aggiunti.
Segmentazione AssetGroupAsset Supporto dei nuovi segmenti AssetGroupAsset ora 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 generazione 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 di Shopping Correzione di bug È stato corretto l'ambito delle metriche di 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).

Note di rilascio archiviate

Consulta Versioni ritirate per le note di rilascio archiviate.