Note di rilascio

Consulta Ritiro delle funzionalità per un elenco aggiornato dei ritiri delle funzionalità attuali e pianificati, la Tabella di marcia per il ritiro e la disattivazione per le date del ciclo di vita delle versioni e Esegui l'upgrade della versione dell'API per le tabelle delle differenze proto da versione a versione filtrabili.

Riepilogo della release e link rapidi

Utilizza la tabella seguente per passare direttamente alle modifiche che provocano un errore, alle nuove funzionalità o alle tabelle delle differenze dei proto di una release:

Versione Data di uscita Modifiche che provocano un errore Funzionalità e aggiornamenti Tabella delle differenze dei proto
v26.1 (versione più recente) 2026-10-28 Nessuno (release secondaria) Funzionalità e aggiornamenti della versione 26.1 v25 versus v26 proto diffs
v26 2026-10-14 Modifiche che provocano un errore nella versione v26 Funzionalità e aggiornamenti della versione 26 v25 versus v26 proto diffs
v25.2 2026-09-23 Nessuno (release secondaria) Funzionalità e aggiornamenti della versione 25.2 v24 versus v25 proto diffs
v25.1 2026-08-19 Nessuno (release secondaria) Funzionalità e aggiornamenti della versione 25.1 v24 versus v25 proto diffs
v25 2026-07-22 Modifiche che provocano un errore nella versione v25 Funzionalità e aggiornamenti della versione 25 v24 versus v25 proto diffs
v24.2 2026-06-24 Nessuno (release secondaria) Funzionalità e aggiornamenti della versione 24.2 Differenze tra i proto v23 e v24
v24.1 2026-05-13 Nessuno (release secondaria) Funzionalità e aggiornamenti della versione 24.1 Differenze tra i proto v23 e v24
v24 2026-04-22 Modifiche che provocano un errore della versione v24 Funzionalità e aggiornamenti della versione 24 Differenze tra i proto v23 e v24
v23.3 2026-06-24 Nessuno (release secondaria) Funzionalità e aggiornamenti della versione 23.3 Differenze tra i proto v22 e v23
v23.2 2026-03-25 Nessuno (release secondaria) Funzionalità e aggiornamenti della versione 23.2 Differenze tra i proto v22 e v23
v23.1 2026-02-25 Nessuno (release secondaria) Funzionalità e aggiornamenti della versione 23.1 Differenze tra i proto v22 e v23
v23 28/01/2026 Modifiche che provocano un errore della versione v23 Funzionalità e aggiornamenti della versione 23 Differenze tra i proto v22 e v23

Versioni principali e secondarie v26

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

v26.1 (28/10/2026)

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

Funzionalità e aggiornamenti Tipo Descrizione
Asset
Monitoraggio dell'utilizzo delle promozioni esterne Nuovi messaggi, campi, enum ed errori

È stato aggiunto il campo immutabile PromotionAsset.external_redeem_info di tipo ExternalRedeemInfo per specificare i dettagli di monitoraggio dell'utilizzo esterno per una promozione:

È stato aggiunto anche il codice di errore AssetError.PARTNER_PROMOTION_ID_TYPE_INCOMPATIBLE, che l'API restituisce quando il campo partner_promotion_id utilizza un formato non accettato dall'integrazione delle promozioni dell'account.
Campagne
Assegnazione della priorità dei canali con struttura a cascata e limiti di budget per i budget delle campagne Nuove funzionalità, risorse, servizi, campi ed enum

È stato aggiunto il supporto per la priorità dei canali a cascata e i limiti di budget sui budget delle campagne, che ti consentono di controllare l'allocazione di un budget tra i canali della rete (proprietà di Google, rete dei partner di ricerca e Rete Display di Google). Per saperne di più, consulta il blog post sulla priorità dei canali e sull'allocazione del budget.
Errore di attivazione della campagna Demand Gen di cui è stata eseguita la migrazione Nuovo enum ed errore È stato aggiunto l'enum DemandGenCampaignError con il codice di errore DemandGenCampaignError.CANNOT_ACTIVATE_MIGRATED_CAMPAIGN. L'API restituisce questo errore se provi ad attivare una campagna Demand Gen di cui è stata eseguita la migrazione prima di rimuovere la campagna originale o mentre è attiva un'altra campagna di cui è stata eseguita la migrazione per la stessa campagna originale.
Generale
Dettagli sui servizi e sulle categorie di idoneità di Servizi locali Nuovi servizi, messaggi e campi

È stato aggiunto il servizio LocalServicesEligibilityService con il metodo LocalServicesEligibilityService.CheckLocalServicesEligibility per verificare l'idoneità a Servizi locali per un cliente e l'ID scheda di Profilo dell'attività su Google (CheckLocalServicesEligibilityRequest). Il messaggio CheckLocalServicesEligibilityResponse restituisce:
Impostazioni del fornitore di riscatto esterno di Servizi locali Campo aggiornato, nuovi messaggi e nuovi campi Il campo Customer.local_services_settings è stato aggiornato da OUTPUT_ONLY a modificabile. È stato aggiunto anche il campo LocalServicesSettings.redemption_provider_info di tipo RedemptionProviderInfo per configurare il fornitore di servizi di riscatto esterno per un account Servizi locali. Questo messaggio contiene il campo obbligatorio RedemptionProviderInfo.external_merchant_id di tipo ExternalPartnerMerchantId, che contiene un ID commerciante di tipo numero intero (numeric_id) o una stringa di 1-50 caratteri (alphanumeric_id).
Consigli
Consiglio Ottimizza per acquisire nuovi clienti Nuovo consiglio

È stato aggiunto il valore dell'enum RecommendationType.OPTIMIZE_FOR_NEW_CUSTOMERS e i seguenti campi per supportare l'ottimizzazione delle campagne per l'acquisizione di nuovi clienti (con valori di conversione incrementali espressi in unità standard della valuta locale dell'account, non in micro):
Report
Bucket di frequenza dei report sulla copertura e informazioni sullo stato delle metriche Nuove metriche, messaggi ed enum

Sono state aggiunte le seguenti metriche al messaggio Metrics, completando l'insieme di bucket di frequenza N+ (da 1+ a 10+) per i report sulla copertura:

Sono state aggiunte anche le seguenti metriche ReachMetricInfo al messaggio Metrics per fornire ulteriori informazioni sullo stato (il campo ReachMetricInfo.reach_metric_states di tipo ReachMetricState, ad esempio quando un valore viene soppresso per motivi di privacy o qualità) per ogni metrica degli utenti unici:
Supporto della quota impressioni superiore sulla rete di ricerca e della quota clic sulla rete di ricerca per i segmenti di annunci verticali e itinerari di prenotazione di hotel Metriche e segmenti aggiornati

Supporto esteso per le metriche Metrics.search_top_impression_share e Metrics.search_click_share in modo da poterle selezionare con i seguenti segmenti di annunci verticali e itinerari di prenotazione di hotel:
Targeting
Esclusioni del reddito del nucleo familiare nelle campagne Performance Max Assistenza estesa È stato aggiunto il supporto per le esclusioni del reddito del nucleo familiare nelle campagne Performance Max. Escludi le fasce di reddito del nucleo familiare creando una risorsa CampaignCriterion negativa con il campo income_range impostato.

v26 (14/10/2026)

Le seguenti nuove funzionalità, aggiornamenti e modifiche che provocano un errore sono stati aggiunti alla versione 26 dell'API Google Ads, 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
Campagne
Campo country_code facoltativo 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 Servizi locali.
Conversione
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 controllare 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 rimangono supportati solo per gli annunci per hotel nelle campagne per hotel e nelle campagne sulla rete di ricerca per i viaggi. Gli ID criterio, il comportamento di targeting e i modificatori di offerta esistenti rimangono invariati e i valori di min_nights e max_nights vengono trasferiti a min_days e max_days senza conversione. Per saperne di più, consulta Modifica le offerte con i modificatori di offerta.
HotelDateSelectionType e tipo di segments.user_set_dates DateSelectionType Rinomina/modifica del tipo Utilizza DateSelectionType anziché HotelDateSelectionType per i modificatori di offerta user_set_dates e segments.user_set_dates.
Motivi degli errori 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 invasivi)

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 Aggiunto a AssetGroupError per indicare quando una categoria specificata in GoogleLocalServicesInfo (AssetGroup.google_local_services_info) non è supportata per le campagne Performance Max di Servizi locali.
Campagne
Creazione di una campagna 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 hotel (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 di Demand Gen Nuovo campo È stato aggiunto il campo demand_gen_info.minimum_budget_per_day_micros a CurrencyConstant, che specifica il budget giornaliero minimo 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 che 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 pubblicità 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 per località positive della campagna all'interno dell'UE
    • Non contiene criteri di campagna per gruppi di località o prossimità positivi
    • Contiene almeno un criterio di campagna per località positiva 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 del gruppo di annunci per località positivi all'interno dell'UE
    • Non contiene criteri per gruppi di annunci per prossimità o gruppi di località positivi
    • Contiene almeno un criterio del gruppo di annunci per località positiva che non si trova nell'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 a livello di gruppo di annunci attivo 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 o meno al territorio dell'UE) o un gruppo di località (indipendentemente dal fatto che si sovrapponga o meno al territorio dell'UE).
Conversione
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 mostrare la configurazione unificata delle conversioni avanzate per l'account, rappresentata utilizzando il nuovo enum EnhancedConversionsConfig.
ConversionActionCategory.MESSAGE_LEAD Nuovo valore enum Aggiunto a ConversionActionCategory per supportare le interazioni di messaggi 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 per l'aumento del budget per la rete di ricerca Nuovo consiglio 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 un errore.

v25.2 (23/09/2026)

Le seguenti nuove funzionalità e i seguenti aggiornamenti sono stati aggiunti alla versione 25.2 dell'API Google Ads. 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 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 scansione url, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL o YOUTUBE) e lo 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à Abbiamo 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 (consulta Converti le campagne intelligenti in campagne Performance Max):
Conversione
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 UNKNOWN generico, l'API ora restituisce BusinessProfileLocationSyncError con motivi specifici (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED e NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
Pianificazione
BenchmarksService.GenerateBenchmarksMetrics metriche percentili Nuove funzionalità

Aggiornato 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 su GenerateBenchmarksMetricsResponse.customer_metrics che su BreakdownMetrics.customer_metrics) e rappresentate utilizzando BenchmarksCustomerPercentileTier.

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

È stato aggiunto il supporto per le metriche dei percentili per le date del trimestre aperto 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 delle quote 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à Aggiornato ContentCreatorInsightsService.GenerateCreatorInsights per supportare la ricerca per 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 dell'itinerario dell'hotel Nuovi segmenti Sono stati aggiunti i seguenti segmenti di dimensione 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 di 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 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 la migrazione automatica imminente ad AI Max.
Conversione
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 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 del lift.
  • Sono state aggiunte 24 nuove metriche per il conversion lift e metriche per il punteggio del vincitore che supportano un'analisi statistica dettagliata del rendimento del lift.
  • Aggiunto il supporto per il recupero dei dettagli della campagna e degli 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 dell'impatto, incluse le date di inizio e di fine del periodo di pubblicazione misurato (start_date e end_date).
Generale
SmartCampaignError Nuovi valori enum 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. 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 disponibili per le offerte. Questo è il 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 effettua la conversione.
  • È stata aggiunta la dimensione principale LOYALTY_MEMBERSHIP per identificare quando è stata soddisfatta una condizione di iscrizione al programma fedeltà 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 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
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, poiché 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 di Incentive Service:
  • 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 allowed_domain facoltativo in AdvertisingPartnerLinkInvitationProperties Campo obbligatorio quando si chiama 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 in modo che utilizzino 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 abilitato, genera immagini animate utilizzando immagini non animate come input. I nuovi DemandGenMultiAssetAds vengono attivati per impostazione predefinita a partire da questa versione dell'API.
Mutabilità 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 È stato aggiornato il supporto dell'obiettivo di acquisizione di nuovi clienti nell'API Google Ads per riflettere lo schema degli obiettivi unificati rinnovato:
Conversione
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 del canale 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. Questo 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

La versione 24 dell'API Google Ads 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 un errore.

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 di 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 Viene restituito quando si tenta di rimuovere tutti i gruppi di asset da una campagna.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS Nuovo valore enum/errore Viene 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 per 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 Viene 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.
Conversione
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 gli esperimenti di mix di campagne e gli 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).

Questa funzionalità è stata sottoposta a backporting 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 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:

"Il campo che si è tentato di modificare è immutabile" o "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 Cambiamento comportamentale Quando nella richiesta viene fornito un indirizzo email non valido, il metodo ora torna correttamente alla restituzione delle 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 con sede 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 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 un errore.

Funzionalità e aggiornamenti Tipo Descrizione
Annunci
DemandGenMultiAssetAdInfo.classic_display_images Nuovo campo Immagini display caricate personalizzate 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 gli 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: 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 Filtri supportati in VerticalAdsItemGroupRuleInfo per la risorsa SharedCriterion.
Metriche dell'esperimento con gruppo di controllo/sperimentale Nuovi campi Sono stati aggiunti i valori di controllo (control_clicks e così via), i valori di trattamento (clicks e così via), le stime puntuali (clicks_point_estimate e così via), i margini di errore (clicks_margin_of_error e così via) e i p-value (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 di Conversions utilizzando i campi di stima puntuale, margine di errore e p-value.
Targeting
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS Nuovo valore enum/errore Viene 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.

v24 (22/04/2026)

Le seguenti nuove funzionalità, aggiornamenti e modifiche che provocano un errore sono stati aggiunti nell'API Google Ads v24, 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
videos e logo_images facoltativi in DemandGenVideoResponsiveAdInfo Campi obbligatori Comportamento diverso Fornisci videos e logo_images durante la creazione o la modifica degli annunci video Demand Gen adattabili.
videos, business_name e logo_images facoltativi in VideoResponsiveAdInfo Campi obbligatori Comportamento diverso Fornisci videos, business_name e logo_images quando crei o modifichi gli annunci 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.
Conversione
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/cambio di 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 deprecati in GenerateKeywordForecastMetrics Nessuno Rimozione Sono stati rimossi i seguenti campi e tipi di piano/previsione: 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.
Segmento click_type 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.
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 per essere allineati 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 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à Attivazione delle esclusioni di genere per le campagne Performance Max in tutte le versioni dell'API Google Ads.
Conversione
Tipi di conversione per la generazione di lead Nuovi valori enum Sono stati aggiunti nuovi enum dei tipi di azioni 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 Aggiunti descrizione del prodotto pianificabile, obiettivo di marketing, modello di costo e metodo di acquisto a ProductCoreAttributes in ListPlannableProductsResponse.
Report
CartDataSalesView Nuova risorsa di reporting Mostra i report che segmentano le metriche sulle 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à È stato introdotto il filtro che utilizza espressioni di insiemi logici in modo dinamico: Questa funzionalità è disponibile solo per gli account nella lista consentita.

Versioni principali e secondarie v23

La versione 23 dell'API Google Ads 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 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:

"Il campo che si è tentato di modificare è immutabile" o "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.
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 un errore.

Funzionalità e aggiornamenti Tipo Descrizione
Asset
VideoEnhancement Nuova risorsa Contiene informazioni sull'annuncio video specifiche per il miglioramento, ad esempio se è generato da Google o fornito dall'inserzionista. Per saperne di più, consulta l'articolo 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 Cambiamento comportamentale 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à 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à target, 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. 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 Elemento 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 opzione è supportata solo per alcuni tipi di annunci.

v23.1 (25/02/2026)

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

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 generati dall'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 di prenotazione di sola lettura.
Campaign.missing_eu_political_advertising_declaration Nuovo campo Supporta l'esecuzione di query e l'applicazione di filtri alle campagne prive di dichiarazioni relative alla presenza o meno di pubblicità politica destinata all'UE.
Conversione
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS Nuovo valore enum Supporta il monitoraggio degli utenti che guardano un annuncio e, in un secondo momento, un video dello stesso canale.
Generale
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED Nuovo valore enum/errore Viene restituito quando si tenta di scegliere come target solo la categoria Non determinato 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 GOOGLE_DISPLAY_NETWORK è stata aggiunta come piattaforma 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 quanti utenti 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 Aggiunta di VERTICAL_ADS_DATA_FEED per supportare i feed di dati degli annunci verticali, come il targeting delle entità degli annunci per 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)

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 di sola 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 la Rete 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à/assistenza 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 helper 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.
Conversione
ConversionActionCategory Nuovo valore enum Aggiunta di 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 il tuo (CYO):

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

Gli eventi della vita non sono supportati per altri metodi AudienceInsightsService, come AudienceInsightsService.GenerateAudienceOverlap e AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates Nuovi campi/opzioni La risposta ora include le piattaforme per supportare i suggerimenti sul tasso di conversione in base ai controlli delle piattaforme (ad es. Gmail, Shorts). Supportato solo per le campagne Demand Gen.
LanguageDistribution Nuovo campo/tipo Aggiunto a YouTubeChannelInsights per fornire dettagli sulla distribuzione delle lingue nei contenuti dei canali YouTube.
BenchmarksService Nuovo servizio Confronta i dati della pubblicità su YouTube con i benchmark di settore.
AudienceInsightsService.GenerateAudienceDefinition Nuovo metodo Traduce una descrizione in testo libero di un pubblico di destinazione in attributi di pubblico corrispondenti utilizzando l'AI generativa.
YouTubeChannelInsights.relevance_score Nuovo campo Valuta la pertinenza di un creator per un argomento, ponderata 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 di 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 selezionata 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 Supporto delle 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 e value_per_conversions_by_conversion_date, 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 articoli nelle campagne sulla rete di ricerca con feed per i 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 per la promozione di strutture insieme agli annunci di testo. Controlla i formati con vertical_ads_format_setting e definisci le regole utilizzando vertical_ads_item_group_rule. Report sulla segmentazione per AdFormatType e dimensioni del feed di dati pubblicitari verticali.
Video
AdVideoAssetInfo.ad_video_asset_feature_control Nuovo campo Sono state aggiunte opzioni di controllo delle funzionalità per gli asset annuncio video.
CampaignCriterionError Nuovo valore enum/errore È stato aggiunto il codice di errore INVALID_VIDEO_LINEUP_ID.
Metriche di udibilità di YouTube Nuove metriche Sono state aggiunte metriche di udibilità per gli annunci audio su YouTube, che indicano se un annuncio era udibile e su quante impressioni è stato possibile misurare l'udibilità.

Note di rilascio archiviate

Consulta le versioni ritirate per le note di rilascio archiviate.