升級至最新版本

您可能會定期從舊版 Google Ads API 升級至新版。這可能是因為某個版本即將停用 或是因為您想使用新功能建議您一律升級至最新版本。

請參閱淘汰時間表，規劃升級作業。請參閱版本管理指南，瞭解版本管理的運作方式。

以下檢查清單可協助您開始進行升級程序：

  1. 當您變更主要版本時，端點將會變更。更新用戶端程式庫，以便使用最新的端點。
  2. 查看版本資訊，瞭解 。
  3. 請參閱下表，瞭解升級至哪個版本時，應著重於哪些特定領域。

如要全面瞭解兩個版本的 Proto 之間的差異，請參閱差異表。

v17 至 v18

服務及其元件變更
GoogleAdsService Search 和 SearchStream 要求

如果要求因費用過高而受到限制，系統會傳回 QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION 或 QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION 錯誤，而非 QuotaError.RESOURCE_EXHAUSTED。詳情請參閱這篇網誌文章。
GoogleAdsService SearchGoogleAdsRequest 中的 summary_row_setting 和 return_total_results_count 欄位現在是新 SearchSettings 物件的一部分。
AssetType DISCOVERY_CAROUSEL_CARD 列舉值已重新命名為 DEMAND_GEN_CAROUSEL_CARD。這與先前的變更一致 將探索廣告活動重新命名為需求開發廣告活動。
AudienceInsightsService.GenerateSuggestedTargetingInsights audience、baseline_audience 和 data_month 欄位已移至 audience_definition 欄位。
DemandGenCampaignSettings upgraded_targeting 欄位的預設值現在是 true，而不是 false。
LocalServicesLeadConversation 系統將不再為靜態呼叫填入 phone_call_details.call_recording_url 欄位。

v16 至 v17

服務及其元件變更
GoogleAdsService Search 和 SearchStream 要求

如果查詢費用過高，系統可能會限制您的要求。如果是 您會收到 QuotaError.RESOURCE_EXHAUSTED 錯誤。詳情請參閱這篇網誌文章。
GoogleAdsService Search 要求。

將 page_size 傳遞至 GoogleAdsService.Search 會導致 RequestError.PAGE_SIZE_NOT_SUPPORTED 錯誤。
Campaign和Ad

AdvertisingChannelType 為 DISCOVERY 的廣告活動現在會改為 AdvertisingChannelType 為 DEMAND_GEN。

此外，部分廣告的報表類型和欄位名稱也會有所變更：

  • DISCOVERY_MULTI_ASSET_ADD 會變成 DEMAND_GEN_MULTI_ASSET_ADD，而對應的報表欄位 ad_group_ad.ad.discovery_multi_asset_ad 會變成 ad_group_ad.ad.demand_gen_multi_asset_ad
  • DISCOVERY_CAROUSEL_AD將變為 DEMAND_GEN_CAROUSEL_AD 和對應的報表欄位 ad_group_ad.ad.discovery_carousel_ad將變為 ad_group_ad.ad.demand_gen_carousel_ad
  • DISCOVERY_VIDEO_RESPONSIVE_AD將變為 DEMAND_GEN_VIDEO_RESPONSIVE_AD 和對應的報表欄位 ad_group_ad.ad.discovery_video_responsive_ad將變為 ad_group_ad.ad.demand_gen_video_responsive_ad
AdService 系統將移除 GetAd 端點。這樣就能 AdService 與 Google Ads API 中的其他服務一致。請參閱 擷取指南 物件，以便用於擷取廣告和其他資源類型。
CustomerLifecycleGoal 和 CampaignLifecycleGoal 重新調整生命週期目標區隔的方式。如需完整的總覽，請參閱生命週期目標說明文件中的「區隔目標對象」一節。
ProductLink 執行「GoogleAdsService」搜尋或搜尋串流時 要求 product_link，您現在可以只選取 一個連結的產品如果選取不同已連結產品的多個欄位，系統會顯示 QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE 錯誤。
報表 已將 metrics.sk_ad_network_conversion_value 欄位重新命名為 metrics.sk_ad_network_fine_conversion_value。