Periodicamente, ti consigliamo di eseguire l'upgrade da una versione principale precedente a una versione principale più recente dell'API Google Ads. una versione verrà ritirata o vuoi usare una nuova funzionalità. Ti consigliamo di eseguire sempre l'upgrade alla versione più recente.
Consulta il nostro programma di ritiro per pianificare i tuoi upgrade. Consulta la nostra guida al controllo delle versioni per scoprire come funziona il controllo delle versioni.
Ecco un elenco di controllo per aiutarti a iniziare la procedura di upgrade:
- L'endpoint cambierà quando cambi le versioni principali. Aggiorna le librerie client per utilizzare l'endpoint più recente.
- Leggi le note sulla versione per conoscere le modifiche introdotte in ogni release.
- Controlla le tabelle riportate di seguito per conoscere le aree specifiche su cui concentrarti per la versione a cui stai eseguendo l'upgrade.
Per una panoramica completa delle modifiche basata su una differenza tra i proto delle due versioni, consulta la tabella delle differenze.
da v16 a v17
| Modifiche ai servizi e ai relativi componenti | |
|---|---|
Richieste GoogleAdsService
Search e SearchStream |
L'errore quando la tua richiesta viene limitata perché è troppo costosa sarà
|
GoogleAdsService
Search richieste. |
Il passaggio di un |
Campaign e Ad |
Le campagne con Inoltre, alcuni annunci cambieranno il tipo e i nomi dei campi per i report:
|
AdService |
L'endpoint GetAd verrà rimosso. In questo modo AdService è in linea con gli altri servizi dell'API Google Ads. Consulta la nostra guida al recupero di oggetti 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 relativa alla segmentazione dei segmenti di pubblico della documentazione relativa agli obiettivi del ciclo di vita. |
ProductLink |
Quando esegui una richiesta di stream di ricerca o di ricerca GoogleAdsService per product_link, ora puoi selezionare solo i campi relativi a un prodotto collegato. La selezione di più campi da diversi prodotti collegati
comporterà un errore QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. |
| Reporting | Il campo metrics.sk_ad_network_conversion_value è stato rinominato in
metrics.sk_ad_network_fine_conversion_value. |
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,
eseguirai 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:
|
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 perché non è più necessario.
Scopri la modifica al ImageAdInfo di seguito.
|
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. Le informazioni vengono ora restituite nel campo feed_label.
|
ProductBiddingCategoryConstant
|
Sostituito con
ProductCategoryConstant.
Più campi sono stati rinominati di conseguenza. Vedi le tre modifiche successive.
|
ListingDimensionInfo
|
Il campo product_bidding_category è stato sostituito con product_category.
|
ListingGroupFilterDimension
|
Il campo product_bidding_category è stato sostituito con product_category.
|
shopping_performance_view
segnalazione |
Di seguito sono riportati i campi dei segmenti:
|
Campaign.shopping_setting
|
È stato rimosso il supporto per la creazione di campagne sulla rete di ricerca con questo campo. |
CampaignCriterion.listing_scope
|
È stato rimosso il supporto per la creazione di campagne sulla rete di ricerca con questo campo. |
sk_ad_network_conversions
segnalazione |
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 customera: 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 di 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 enum:
YOUTUBE.
|