Note di rilascio

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

Versione principale v26

La versione 26 dell'API Google Ads include le seguenti nuove funzionalità, aggiornamenti e modifiche che provocano errori.

v26 (14/10/2026)

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

Per istruzioni, consulta Esegui l'upgrade all'ultima versione.

Modifiche che provocano un errore

Stato iniziale Nuovo stato Tipo di modifica Linee guida per l'implementazione
Campagne
Campo facoltativo country_code in LocalServicesPmaxCampaignSettings Campo obbligatorio durante la creazione della campagna Performance Max per Servizi locali (LocalServicesPmaxCampaignSettings.country_code) comportamento diverso Assicurati di specificare country_code (insieme al nuovo listing_id obbligatorio) quando crei campagne Performance Max per i servizi locali.
Conversioni
Il campo enhanced_conversions_for_leads_enabled in ConversionTrackingSetting (Customer.conversion_tracking_setting) Nessuno Rimozione Utilizza invece ConversionTrackingSetting.enablement_setting su Customer.conversion_tracking_setting per esaminare l'impostazione delle conversioni avanzate a livello di account.
Targeting
Campi dei criteri specifici per gli hotel in AdGroupBidModifier:
  • hotel_date_selection_type
  • hotel_advance_booking_window
  • hotel_length_of_stay (min_nights e max_nights)
  • hotel_check_in_day
  • hotel_check_in_date_range
 Campi dei criteri indipendenti dal verticale in AdGroupBidModifier: Rinomina / rimozione Aggiorna i riferimenti per utilizzare i campi dei criteri indipendenti dal verticale, che supportano il targeting in tutti i verticali di viaggio oltre agli hotel (ad esempio, Cose da fare). Gli ID criterio, il comportamento di targeting e i moltiplicatori di offerta esistenti rimangono invariati. I valori di min_nights e max_nights vengono trasferiti a min_days e max_days così come sono.
HotelDateSelectionType e tipo di segments.user_set_dates DateSelectionType Rinomina / modifica tipo Utilizza DateSelectionType anziché HotelDateSelectionType.
Motivi di errore specifici dell'hotel in CriterionError:
  • HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION
  • HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY
  • HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE
  • HOTEL_CHECK_IN_DATE_RANGE_REVERSED
 Motivi degli errori indipendenti dal verticale in CriterionError: Rinomina Aggiorna la gestione degli errori per verificare i nuovi motivi di errore indipendenti dal verticale.

Funzionalità e aggiornamenti (non distruttivi)

Funzionalità e aggiornamenti Tipo Descrizione
Asset
Fornitori di messaggi aziendali LINE e SMS Nuovi campi e valori enum È stato aggiunto il supporto di LINE e SMS come fornitori di messaggi in BusinessMessageAsset, inclusi i nuovi campi BusinessMessageAsset.line_info e BusinessMessageAsset.sms_info, oltre a BusinessMessageProvider.LINE e BusinessMessageProvider.SMS.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY Nuovo valore enum / errore Aggiunta a AssetGroupError per indicare quando una categoria specificata in GoogleLocalServicesInfo (AssetGroup.google_local_services_info) non è supportata per le campagne Performance Max per i servizi locali.
Campagne
Creazione di campagne Performance Max per Servizi locali Nuove funzionalità, campi ed errori

Aggiornato PmaxCampaignSettings.local_services_enabled da OUTPUT_ONLY a IMMUTABLE, consentendo ai client API esterni di specificare local_services_enabled = true durante la creazione di nuove campagne Performance Max di Servizi locali.

È stato aggiunto anche LocalServicesPmaxCampaignSettings.listing_id per mostrare l'ID della scheda Profilo dell'attività su Google collegata alla campagna Performance Max di Servizi locali (contrassegnata come OBBLIGATORIA durante la creazione della campagna Performance Max di Servizi locali) ed è stato aggiunto il codice di errore CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID.
Errori di convalida della campagna Servizi locali Nuovi valori enum ed errori Sono stati aggiunti nuovi errori di convalida per le campagne di Servizi locali:
Convalida del collegamento dell'account Hotel Center Nuovo valore enum / errore È stato aggiunto il codice di errore CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED a CampaignError per indicare che il collegamento di un insieme di asset di una struttura alberghiera (Campaign.hotel_property_asset_set) a una campagna Performance Max per gli obiettivi di viaggio richiede un collegamento attivo all'account Hotel Center.
Budget minimo giornaliero per Demand Gen Nuovo campo È stato aggiunto il campo demand_gen_info.minimum_budget_per_day_micros a CurrencyConstant, che specifica il budget minimo giornaliero richiesto per le campagne Demand Gen in quella valuta. Il valore di questo campo viene aggiornato quando cambia il budget minimo applicato dall'API.
Configurazione della misurazione dell'impatto per le campagne Nuovo campo È stato aggiunto Campaign.lift_measurement_config per mostrare il nome della risorsa della configurazione della misurazione del lift collegata alla campagna.
Convalida dell'esperimento AI Max Nuovo valore enum / errore È stato aggiunto il codice di errore ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED a ExperimentArmError quando si tenta di creare un esperimento ADOPT_AI_MAX per una campagna per cui è già stato attivato AI Max (o viene attivato nella stessa richiesta prima della creazione del gruppo sperimentale).
Tipo di scheda della campagna Shopping Assistenza estesa Supporto esteso di Campaign.listing_type alle campagne Shopping.
Aggiornamenti dell'autodichiarazione relativa alla propaganda politica nell'UE Comportamento aggiornato e nuovi campi

Campaign.contains_eu_political_advertising è ora facoltativo per alcune campagne che non hanno come target l'Unione Europea.

  • Ad eccezione di quanto indicato per le campagne DEMAND_GEN con targeting con upgrade eseguito, il campo è facoltativo se una campagna soddisfa tutte le seguenti condizioni dopo l'esecuzione della richiesta:
    • Non contiene criteri della campagna per località positivi all'interno dell'UE
    • Non contiene criteri della campagna per prossimità o gruppo di località positivi
    • Contiene almeno un criterio di campagna per località positivo al di fuori dell'UE
  • Per le campagne DEMAND_GEN con upgraded_targeting, il campo è facoltativo se ogni gruppo di annunci attivo all'interno della campagna soddisfa tutte le seguenti condizioni dopo l'esecuzione della richiesta:
    • Non contiene criteri per gruppi di annunci con località positiva all'interno dell'UE
    • Non contiene criteri del gruppo di annunci per gruppo di località o prossimità positivi
    • Contiene almeno un criterio del gruppo di annunci per località positivo al di fuori dell'UE
    Il campo è facoltativo anche per le campagne senza gruppi di annunci attivi. Se una richiesta crea un gruppo di annunci che non soddisfa queste condizioni, viene restituito AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION.
  • Queste modifiche si applicano alle campagne nuove ed esistenti. In alcuni casi, è possibile creare una nuova campagna solo se i criteri vengono aggiunti nella stessa richiesta. Utilizza GoogleAdsService.Mutate per raggruppare le modifiche.
  • Campaign.missing_eu_political_advertising_declaration aggiornato in modo che corrisponda alle modifiche apportate a Campaign.contains_eu_political_advertising.
  • Aggiunta di GeoTargetConstant.require_eu_political_advertising_declaration per indicare se una località si trova all'interno o all'esterno dell'UE.
  • CampaignCriterion.require_eu_political_advertising_declaration e AdGroupCriterion.require_eu_political_advertising_declaration aggiunti. Campaign.contains_eu_political_advertising è obbligatorio se questo campo è true per qualsiasi criterio a livello di campagna all'interno della campagna (o per qualsiasi criterio attivo a livello di gruppo di annunci nelle campagne DEMAND_GEN con targeting aggiornato). I campi restituiscono true se il campo negative del criterio è false e il criterio è una località all'interno dell'UE, una prossimità (indipendentemente dal fatto che si sovrapponga al territorio dell'UE) o un gruppo di località (indipendentemente dal fatto che si sovrapponga al territorio dell'UE).
Conversioni
Configurazione unificata delle conversioni avanzate Nuovi campi ed enum Sono stati aggiunti ConversionTrackingSetting.enablement_setting e ConversionTrackingSetting.effective_enablement_setting (su Customer.conversion_tracking_setting) per esporre la configurazione unificata delle conversioni avanzate per l'account, rappresentata utilizzando il nuovo enum EnhancedConversionsConfig.
ConversionActionCategory.MESSAGE_LEAD Nuovo valore enum Aggiunta a ConversionActionCategory per supportare le interazioni di messaggistica o chat che indicano interesse per l'offerta di un inserzionista.
ConversionAttributionEventType.CLICK Nuovo valore enum Aggiunto a ConversionAttributionEventType per rappresentare le conversioni attribuite a un clic sull'annuncio, che in precedenza erano incluse nel valore enum UNKNOWN.
Generale
Aggiornamenti dei lead di Servizi locali Nuovo campo e valore enum
Consigli
Consiglio di aumento del budget per la rete di ricerca Nuovo suggerimento Sono stati aggiunti RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation e ApplyRecommendationOperation.raise_budget_performance_too_low per supportare l'aumento dei budget quando i budget giornalieri sono troppo bassi per le campagne sulla rete di ricerca.
Report
Misurazioni del search lift Nuove funzionalità, risorse, segmenti e metriche È stato aggiunto il supporto per le misurazioni del search lift:
Visualizzazione degli asset di espansione dell'URL finale per le campagne Shopping Assistenza estesa final_url_expansion_asset_view è stato ampliato per supportare le campagne Shopping (con ad_group selezionabile come risorsa attribuita insieme a final_url_expansion_asset_view.ad_group).
Video
Informative sui contenuti generativi di YouTube Nuovi campi ed enum È stato aggiunto il supporto per le informative sui contenuti generativi per i caricamenti su YouTube. Il nuovo campo YouTubeVideoUpload.video_content_metadata di tipo VideoContentMetadata è stato aggiunto a YouTubeVideoUpload e contiene le impostazioni di divulgazione in VideoContentMetadata.generative_content_disclosure di tipo YouTubeVideoUploadGenerativeContentDisclosure.

Versioni principali e secondarie v25

La versione 25 dell'API Google Ads include le seguenti nuove funzionalità, aggiornamenti e modifiche che provocano errori.

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 enum È 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 un url di scansione, un source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL o YOUTUBE) e uno stato di attivazione enabled.
Errori del moltiplicatore del valore di 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 del 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 degli annunci Firebase Nuovi tipi e categorie di azioni di conversione Sono stati esposti i tipi di azioni di conversione FIREBASE_ANDROID_APP_AD_IMPRESSION e FIREBASE_IOS_APP_AD_IMPRESSION, consentendoti di recuperare e modificare queste azioni di conversione. È stata inoltre esposta la categoria IN_APP_AD_REVENUE in ConversionActionCategory per monitorare le entrate generate dalla monetizzazione degli annunci in-app.
Generale
BusinessProfileLocationSyncError Nuovi 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 del percentile BenchmarksService.GenerateBenchmarksMetrics Nuove funzionalità

Aggiornato BenchmarksService.GenerateBenchmarksMetrics per fornire metriche che rappresentano la posizione competitiva del cliente rispetto ad altri inserzionisti in formato di 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 se in GenerateBenchmarksMetricsRequest sono soddisfatte entrambe le seguenti condizioni:

È stato aggiunto il supporto per le metriche dei percentili per le date dei trimestri aperti all'interno di ListBenchmarksAvailableDatesResponse.supported_dates (restituito da BenchmarksService.ListBenchmarksAvailableDates). Sebbene le metriche aggregate dei clienti (CustomerMetrics.aggregate_metrics), le metriche dei tassi dei clienti (CustomerMetrics.average_rate_metrics) e le metriche dei percentili dei clienti (CustomerMetrics.percentile_metrics) siano supportate per tutte le date in supported_dates (inclusi i trimestri aperti), le metriche della quota dei clienti (CustomerMetrics.share_metrics) e le metriche dei tassi della fonte dei benchmark (average_benchmarks_metrics, ad esempio average_cpm degli annunci "/Apparel/Clothing") non sono supportate per i trimestri aperti e vengono omesse dalla risposta, a meno che il valore date_range richiesto non rientri nell'intervallo ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics più ristretto.

È stato aggiunto un errore BenchmarksError.NO_METRICS_FOUND personalizzato 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 su CPA e 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 dimensione itinerario 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 per i verticali 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)

Le seguenti nuove funzionalità e i seguenti aggiornamenti sono stati aggiunti alla versione 25.1 dell'API Google Ads. Le versioni secondarie come la v25.1 non contengono modifiche che provocano errori.

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 la migrazione automatica imminente ad AI Max.
Conversioni
Misurazioni del brand lift Nuove funzionalità 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 dell'impatto sulle conversioni 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 del lift.
  • Sono state aggiunte 24 nuove metriche di 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.
  • 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 periodo di pubblicazione per una configurazione della misurazione del lift, incluse le date di inizio e di fine del periodo di pubblicazione 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 Viene 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à Aggiunto il supporto per le categorie come filtri per definire l'ambito di un'analisi dei benchmark. Sono supportate anche altre metriche fondamentali per l'attività:
Targeting per stato parentale Nuova funzionalità È stato aggiunto il supporto per il targeting per 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 suggerimento 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 disponibili per le 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à dell'utente 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 completato una 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 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 provocano un errore sono stati aggiunti nell'API Google Ads v25, che è una release principale.

Per istruzioni, consulta Esegui 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 rispettivamente di value_adjustment e high_lifetime_value_adjustment oneof, 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 corrispondenti CustomerLifecycleGoalService e CampaignLifecycleGoalService e impostazioni/enum 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 consumer 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 il numero CreateProductLinkInvitation per un partner pubblicitario comportamento diverso Assicurati di fornire allowed_domain quando crei un invito al collegamento del prodotto 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 tue integrazioni per utilizzare il nuovo tipo CustomerMetrics, che contiene solo metriche che rappresentano il rendimento dell'annuncio del cliente.

Funzionalità e aggiornamenti (non invasivi)

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. I nuovi DemandGenMultiAssetAds vengono attivati per impostazione predefinita a partire da questa versione dell'API.
Modificabilità delle informazioni sui contenuti sintetici Modifica del comportamento Asset.synthetic_content_info e Ad.synthetic_content_info sono ora completamente modificabili nelle versioni v25, v24 e v23.
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: Per saperne di più, consulta l'articolo del Centro assistenza.
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 provocano un errore.

v24.2 (24/06/2026)

Le seguenti nuove funzionalità e i seguenti aggiornamenti sono stati aggiunti alla versione 24.2 dell'API Google Ads. 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 di coinvolgimento per le istanze DemandGenVideoResponsiveAd (che vengono attivate per impostazione predefinita a partire da questa versione dell'API).
Asset
AssetGroup.google_local_services_info Nuovo campo Aggiunto per supportare le informazioni degli annunci di Servizi locali (ID categoria e callout) nelle campagne Performance Max.
AssetGroupSignal.local_services_id Nuovo campo Aggiunto per supportare gli indicatori dell'ID servizio degli annunci di Servizi locali nelle campagne Performance Max.
AssetGroupSignal.vertical_ads_item_group_rule_list Nuovo campo Aggiunto per supportare le regole dei gruppi di articoli degli annunci verticali per la selezione degli articoli 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 Supporto per l'identificazione delle campagne Performance Max di 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 Servizi locali.
SmartCampaignErrorEnum.CREATION_FAILED Nuovo valore enum / errore Viene restituito quando si tenta 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 i contenuti sintetici/generati con l'AI, suddivise in advertiser_attestation (dichiarazioni fornite direttamente dall'inserzionista) e system_attestation (attestazioni rilevate o fornite automaticamente dal sistema).

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

Per aiutarti a pianificare le prossime attività di integrazione per la versione 25, l'interfaccia per la modifica dei campi di attestazione dell'inserzionista verrà 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 provi a eseguire 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 tua logica interna, in modo che il tuo sistema sia pronto per le funzionalità di scrittura complete quando verrà lanciata la versione v25.
Autorizzazione da più parti Nuove funzionalità È stato aggiunto il supporto per le revisioni con autorizzazione da più parti (MPA):
Questa funzionalità è stata sottoposta a 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 Aggiunta 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 filtri in base alle funzionalità.
GenerateCreatorInsightsRequest.supplemental_data
GenerateTrendingInsightsRequest.supplemental_data		 Nuovi campi Input facoltativi per i metodi ContentCreatorInsightsService. Se fornisci questo campo, nella risposta vengono compilati attributi aggiuntivi relativi alle località o ai creator.
local_creator_insights
related_local_creators		 Nuovi campi Viene compilato quando supplemental_data contiene l'enum 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, che consente di cercare approfondimenti sulle tendenze utilizzando la località del paese e le località secondarie del paese.
Report
PerformanceMaxPlacementView Estensione dei segmenti Reso segmentabile da ad_network_type.
Shopping
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads Nuovo campo Se impostato su 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 Viene 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 del brand di YouTube collegato.

v24.1 (13/05/2026)

Le seguenti nuove funzionalità e i seguenti aggiornamenti sono stati aggiunti alla versione 24.1 dell'API Google Ads. 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 in che modo 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 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: i dettagli degli asset associati alle copie sperimentali degli annunci.
  • asset_groups: elenco dei gruppi di asset nel gruppo sperimentale per gli esperimenti Ottimizza gli 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 Viene restituito quando la granularità temporale giornaliera, oraria o settimanale richiesta non è supportata per gli intervalli di date delle 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 di 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 Pubblicazione di ZEFR come partner di integrazione per la visibilità di terze parti.
DataLink.youtube_video.channel_id Nuovo campo Espone l'ID canale YouTube associato al collegamento ai dati.

Versione 24 (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 Esegui 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 durante la creazione o la modifica degli 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 Registrazioni ai programmi fedeltà è stata rimossa. Rimuovi i riferimenti al codice.
Pianificazione
Tipo InsightsAudienceAttributeGroup per topic_audience_combinations Tipo di common.InsightsAudienceAttributeGroup Comportamento diverso / Modifica del 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 selezioni 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 disponibile 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 pianificazione / previsione 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 un ID al loro interno non supera la convalida.
ShareablePreviewError codici legacy: 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 invasivi)

Funzionalità e aggiornamenti Tipo Descrizione
Annunci
Mutabilità di VideoResponsiveAdInfo Cambiamento comportamentale Gli oggetti informativi degli annunci video adattabili ora sono modificabili.
Asset
travel_feed_data in AssetSet Nuovo campo Aggiunto per recuperare gli attributi degli asset del feed di viaggio (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 per la generazione di lead 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 Viene restituito quando si tenta di creare più elenchi 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 di reporting Espone i report che segmentano le metriche delle conversioni in base al prodotto specifico venduto (brand e così via) oltre al prodotto selezionato.
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.
Filtri dei prodotti basati su tag Nuova funzionalità È stata introdotta la funzionalità di filtro 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 provocano un errore.

v23.3 (24/06/2026)

Le seguenti nuove funzionalità e i seguenti aggiornamenti sono stati aggiunti alla versione 23.3 dell'API Google Ads. 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, suddivisi in advertiser_attestation (dichiarazioni fornite direttamente dall'inserzionista) e system_attestation (attestazioni rilevate o fornite automaticamente 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 provi a eseguire 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 momento del lancio della versione 25.
Approvazioni da più parti Nuove funzionalità È stato aggiunto il supporto per le revisioni delle approvazioni da più parti (MPA):

v23.2 (25/03/2026)

Le seguenti nuove funzionalità e i seguenti aggiornamenti sono stati aggiunti alla versione 23.2 dell'API Google Ads. 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 l'articolo Informazioni sui miglioramenti video.
AppTopCombinationView Nuova risorsa Risorsa di sola lettura per fornire informazioni 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 Fornire 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 di utenti ritirata.
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 Aggiunta a ReachPlanService.ListPlannableProducts, che sostituirà youtube_select_lineups. Entrambi i campi sono attualmente compilati.
ReachPlanSurface Nuovo valore enum IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS è stato aggiunto come opzione di piattaforma.
Forecast Nuovo campo Aggiunta di 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 Aggiunta 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à fare pubblicità solo su questo dominio.
Customer.contains_eu_political_advertising Nuovo campo Recupera lo stato della dichiarazione a livello di account che indica se contiene pubblicità politica destinata all'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 dello stato principale per le 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 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 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 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 a TrendInsights quando si esegue 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 Aggiunto VERTICAL_ADS_DATA_FEED per supportare i feed di dati degli annunci verticali, ad esempio il targeting delle entità degli annunci di viaggio.
YouTubeVideoUpload
YouTubeVideoUpload Nuovo servizio / risorsa È stato aggiunto il servizio YouTubeVideoUpload per supportare il caricamento e la gestione dei video su YouTube, nonché 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)

Le seguenti nuove funzionalità, aggiornamenti e modifiche che provocano un errore sono stati aggiunti nell'API Google Ads v23, che è una release principale.

Per indicazioni, consulta Esegui 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 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 di 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
Enum e metriche delle etichette di rendimento degli asset aggregati Nessuno Rimozione Sono state rimosse le metriche aggregate delle etichette di rendimento degli asset. L'enum dell'etichetta di rendimento non viene più restituito per la rete di ricerca e Display.

Funzionalità e aggiornamenti (non invasivi)

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 È stato aggiunto un campo di orientamento di sola lettura 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 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 inviato 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 stati aggiunti enum di supporto per gli oneri normativi e le 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 un secondo momento, 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
Aggiunto il supporto per gli incentivi Scegli tu (CYO):

Per facilitare una gestione programmatica più granulare degli errori, aggiungeremo altri codici di errore a IncentivesService nelle release future. 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 Aggiunta a YouTubeChannelInsights per fornire i dettagli sulla distribuzione delle lingue nei contenuti dei canali YouTube.
BenchmarksService Nuovo servizio Confronta i dati pubblicitari di YouTube con i benchmark di settore.
AudienceInsightsService.GenerateAudienceDefinition Nuovo metodo Traduce una descrizione in testo libero di un pubblico di destinazione in attributi del pubblico corrispondenti utilizzando l'AI generativa.
YouTubeChannelInsights.relevance_score Nuovo campo Valuta la pertinenza di un creator per un argomento ponderato 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 dettagliata 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 di nuovi segmenti Supporta le metriche 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 di 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 Aggiunto PerStoreView per eseguire query sui dettagli della posizione del negozio e MatchedLocationInterestView (per le campagne AI Max) per fornire metriche sul rendimento in base alle posizioni 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, value_per_conversions_by_conversion_date e value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView Supporto di nuove metriche 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 elementi 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 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 struttura insieme agli annunci di testo. Controlla i formati con vertical_ads_format_setting e definisci le regole utilizzando vertical_ads_item_group_rule. Report segmentati in base a AdFormatType e alle dimensioni del feed di dati degli annunci 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à.

Note di rilascio archiviate

Consulta le versioni ritirate per le note di rilascio archiviate.