升級至最新版本

建議您定期將 Google Ads API 的主要版本升級為較新的主要版本。這可能是因為版本已淘汰 也可能是您需要使用新功能建議您一律升級至最新版本。

請參閱我們的淘汰時間表，規劃升級事宜。如要瞭解版本管理的運作方式，請參閱版本管理指南。

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

  1. 如果您變更主要版本，端點將隨之改變。更新用戶端程式庫以使用最新的端點。
  2. 瀏覽「版本資訊」，瞭解我們在各個版本中加入的變更。
  3. 請參閱下表，瞭解要升級到哪個版本的重點部分。

如要根據兩個版本與 proto 之間的差異，查看完整的變更總覽，請參閱差異表。

v15 至 v16

服務及相關元件的變更
AccountLink 已移除 linked_account 中的 data_partner 和 google_ads 連結。請改用 ProductLinkService 和 ProductLinkInvitationService。
CampaignLifecycleGoal 先前更新現有的 CampaignLifecycleGoal 時，應發出具有特定需求的 create 作業。您現在可以改為發出 update 作業，就跟其他資源類型一樣。
Error Reporting 系統現在傳回一般 ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT 錯誤的兩個情況，會產生更具體的錯誤訊息：
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata 移除 score 欄位，
KeywordMatchTypeRecommendation 如未設定關鍵字比對類型，API 現在會針對 recommended_match_type 欄位傳回 UNSPECIFIED，而非 UNKNOWN。

v14 至 v15

服務及相關元件的變更
AssetGroupListingGroupFilter vertical 列舉欄位已重新命名為 feed_type。
MediaFileService 服務因不再需要而遭到移除。請參閱下方的 ImageAdInfo 變更。
ImageAdInfo media_file 欄位已替換為 image_asset。
MerchantCenterLinkService 服務已由 ProductLinkInvitationService 和 ProductLinkService 取代。
Campaign.ShoppingSetting 移除 sales_country 欄位，這項資訊現在會在 feed_label 欄位中傳回。
ProductBiddingCategoryConstant 已替換為 ProductCategoryConstant。多個欄位已據此重新命名，請參閱下方「接下來三項變更」。
ListingDimensionInfo 將 product_bidding_category 欄位替換為 product_category。
ListingGroupFilterDimension 將 product_bidding_category 欄位替換為 product_category。
shopping_performance_view 報表 下列區隔欄位：
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
已替換為：
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
Campaign.shopping_setting 已停止支援使用這個欄位建立搜尋廣告活動。
CampaignCriterion.listing_scope 已停止支援使用這個欄位建立搜尋廣告活動。
sk_ad_network_conversions 報表 metrics.sk_ad_network_conversions 已替換為 metrics.sk_ad_network_installs。
OfflineConversionClientSummary 將 offline_conversion_client_summaries 欄位從 Customer 移至可單獨查詢的頂層資源。

變更查詢來源：

SELECT customer.offline_conversion_client_summaries
FROM customer
至：
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

使用查詢建構工具探索可用欄位清單，以選取及篩選。
OfflineConversionUploadAlert 已重新命名為 OfflineConversionAlert。
OfflineConversionUploadError 已重新命名為 OfflineConversionError。
AdNetworkType YOUTUBE_SEARCH 和 YOUTUBE_WATCH 列舉已合併為單一列舉： YOUTUBE。