Upgrade all'ultima versione

Periodicamente, potresti eseguire l'upgrade da una versione principale precedente a una versione principale più recente dell'API Google Ads. Il motivo potrebbe essere che una versione è in fase di ritiro o che vuoi usare una nuova funzionalità. Ti consigliamo di eseguire sempre l'upgrade alla versione più recente.

Consulta la pianificazione del ritiro per pianificare gli upgrade. Per scoprire come funziona, consulta la nostra guida al controllo delle versioni.

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

  1. L'endpoint cambierà quando cambierai le versioni principali. Aggiorna le librerie client per utilizzare l'endpoint più recente.
  2. Consulta le note di rilascio per vedere le modifiche introdotte in ogni release.
  3. Consulta le tabelle seguenti per aree specifiche su cui concentrarti per la versione a cui stai eseguendo l'upgrade.

Per una panoramica completa delle modifiche in base alle differenze tra i proto delle due versioni, consulta la tabella delle differenze.

Da v15 a v16

Modifiche ai servizi e ai relativi componenti
AccountLink I link data_partner e google_ads in linked_account sono stati rimossi. Usa invece ProductLinkService e ProductLinkInvitationService.
CampaignLifecycleGoal Quando aggiorni un elemento CampaignLifecycleGoal esistente in precedenza, dovresti emettere un'operazione create con requisiti specifici. Ora puoi eseguire un'operazione update come per altri tipi di risorse.
Error Reporting Due casi in cui l'errore generico ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT è stato restituito ora generano messaggi di errore più specifici:
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata Il campo score è stato rimosso.
KeywordMatchTypeRecommendation Se il tipo di corrispondenza delle parole chiave non è impostato, l'API ora restituisce UNSPECIFIED anziché UNKNOWN per il campo recommended_match_type.

Da v14 a v15

Modifiche ai servizi e ai relativi componenti
AssetGroupListingGroupFilter Il campo enum vertical è stato rinominato in feed_type.
MediaFileService Il servizio è stato rimosso in quanto non è più necessario. Visualizza la modifica di ImageAdInfo qui sotto.
ImageAdInfo Il campo media_file è stato sostituito con image_asset.
MerchantCenterLinkService Il servizio è stato sostituito con ProductLinkInvitationService e ProductLinkService.
Campaign.ShoppingSetting Il campo sales_country è stato rimosso. Ora le informazioni vengono restituite nel campo feed_label.
ProductBiddingCategoryConstant Sostituito con ProductCategoryConstant. Più campi sono stati rinominati di conseguenza; vedi le tre modifiche successive di seguito.
ListingDimensionInfo Campo product_bidding_category sostituito con product_category.
ListingGroupFilterDimension Campo product_bidding_category sostituito con product_category.
shopping_performance_view report I seguenti campi del segmento:
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
sono stati sostituiti con:
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
Campaign.shopping_setting Rimosso il supporto per la creazione di campagne sulla rete di ricerca con questo campo.
CampaignCriterion.listing_scope Rimosso il supporto per la creazione di campagne sulla rete di ricerca con questo campo.
sk_ad_network_conversions report metrics.sk_ad_network_conversions è stato sostituito con metrics.sk_ad_network_installs.
OfflineConversionClientSummary Il campo offline_conversion_client_summaries è stato spostato da Customer a una risorsa di primo livello su cui puoi eseguire query separatamente.

Modifica la query da:

SELECT customer.offline_conversion_client_summaries
FROM customer
per: 
SELECT
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.total_event_count,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.last_upload_date_time,
  ...
FROM offline_conversion_upload_client_summary

Utilizza lo strumento di creazione query per esplorare l'elenco dei campi disponibili per la selezione e l'applicazione di filtri.
OfflineConversionUploadAlert Rinominato in OfflineConversionAlert.
OfflineConversionUploadError Rinominato in OfflineConversionError.
AdNetworkType Le enum YOUTUBE_SEARCH e YOUTUBE_WATCH sono state unite in un'unica enumerazione: YOUTUBE.