Upgrade all'ultima versione

Periodicamente, potresti voler eseguire l'upgrade da una versione principale precedente del API Google Ads a una versione principale più recente. Potrebbe essere perché una versione è in fase di ritiro, o perché vuoi usare una nuova funzionalità. Ti consigliamo di eseguire sempre l'upgrade alla versione più recente.

Consulta il programma del ritiro per pianificare upgrade. Consulta la nostra guida al controllo delle versioni per scoprire come funziona.

Ecco un elenco di controllo per aiutarti a iniziare la procedura di upgrade:

  1. L'endpoint cambierà quando modifichi le versioni principali. Aggiorna il tuo librerie client per utilizzare l'endpoint più recente.
  2. Leggi le note di rilascio per vedere le modifiche in ogni release.
  3. Controlla le tabelle riportate di seguito per conoscere le aree specifiche su cui concentrarti per la versione stai eseguendo l'upgrade.

Per una panoramica completa delle modifiche in base a una differenza tra i proto da le due versioni, guarda la tabella delle differenze.

Da v17 a v18

Modifiche ai servizi e ai relativi componenti
GoogleAdsService Richieste Search e SearchStream

L'errore quando la richiesta viene limitata perché è troppo costosa sarà QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION o QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION anziché QuotaError.RESOURCE_EXHAUSTED. Visita il blog post per ulteriori dettagli.

GoogleAdsService Le summary_row_setting e return_total_results_count campi in SearchGoogleAdsRequest ora fanno parte del nuovo oggetto SearchSettings.
AssetType Il valore enum DISCOVERY_CAROUSEL_CARD è stato rinominato in DEMAND_GEN_CAROUSEL_CARD. È in linea con una modifica precedente per rinominare le campagne discovery in campagne Demand Gen.
AudienceInsightsService.GenerateSuggestedTargetingInsights I campi audience, baseline_audience e data_month sono stati spostati all'interno del campo audience_definition.
DemandGenCampaignSettings Il valore predefinito per il campo upgraded_targeting è ora true anziché false.
LocalServicesLeadConversation Il campo phone_call_details.call_recording_url non verrà più compilato per le chiamate statiche.

da v16 a v17

Modifiche ai servizi e ai relativi componenti
GoogleAdsService Search e richieste SearchStream

La richiesta potrebbe essere limitata se la query è troppo costosa. In tal caso, riceverai l'errore QuotaError.RESOURCE_EXHAUSTED. Per ulteriori dettagli, consulta il post del blog.

GoogleAdsService Search richieste.

Passaggio di page_size a GoogleAdsService.Search in corso... comporterà un errore RequestError.PAGE_SIZE_NOT_SUPPORTED.

Campaign e Ad

Campagne con un AdvertisingChannelType di Ora DISCOVERY avrà un AdvertisingChannelType di DEMAND_GEN in alternativa.

Inoltre, per alcuni annunci cambieranno i tipi e i nomi dei campi per i report:

  • DISCOVERY_MULTI_ASSET_ADD diventerà DEMAND_GEN_MULTI_ASSET_ADD e il campo report corrispondente ad_group_ad.ad.discovery_multi_asset_ad diventerà ad_group_ad.ad.demand_gen_multi_asset_ad
  • DISCOVERY_CAROUSEL_AD diventerà DEMAND_GEN_CAROUSEL_AD e il campo report corrispondente ad_group_ad.ad.discovery_carousel_ad diventerà ad_group_ad.ad.demand_gen_carousel_ad
  • DISCOVERY_VIDEO_RESPONSIVE_AD diventerà DEMAND_GEN_VIDEO_RESPONSIVE_AD e il campo del report corrispondente ad_group_ad.ad.discovery_video_responsive_ad diventerà ad_group_ad.ad.demand_gen_video_responsive_ad

AdService L'endpoint GetAd verrà rimosso. Ciò porta AdService in linea con altri servizi nell'API Google Ads. Consulta le nostre guida al recupero per il metodo consigliato per recuperare annunci e altri tipi di risorse.
CustomerLifecycleGoal e CampaignLifecycleGoal Il modo in cui gestisci i segmenti per gli obiettivi dei cicli di vita è stato rielaborato. Per una panoramica completa, consulta la sezione Segmenta i tuoi segmenti di pubblico della documentazione relativa agli obiettivi del ciclo di vita.
ProductLink Durante l'esecuzione di uno stream di ricerca o di ricerca di GoogleAdsService richiesta per product_link, ora puoi selezionare solo i campi correlati a un prodotto collegato. Selezione di più campi da diversi prodotti collegati produrrà un QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE .
Rapporti Il campo metrics.sk_ad_network_conversion_value è stato rinominato in metrics.sk_ad_network_fine_conversion_value.