2024 年 6 月 5 日，星期三
今天，我們宣布推出 Google Ads API 第 17 版。如要使用部分 v17 功能，您必須升級用戶端程式庫和用戶端程式碼。更新後的用戶端程式庫和程式碼範例將於下週發布。以下是重點摘要：
- 為因應 2024 年 6 月 17 日實施的資源使用政策異動，我們在
QuotaError中新增兩個值，當GoogleAdsService.Search()和GoogleAdsService.SearchStream()要求的查詢模式在一段時間內消耗過多資源時，就會擲回這些值。 page_size欄位一律設為 10,000，您無法再將page_size傳遞至GoogleAdsService.Search。否則會發生RequestError.PAGE_SIZE_NOT_SUPPORTED錯誤。- 新增
campaign_aggregate_asset_view和channel_aggregate_asset_view，用於回報更多最高成效和搜尋廣告活動指標。 - 批次處理異動：
- 新增使用
BatchJobService時設定MutateOperation.asset_group_operation的支援。這樣一來，您就能使用批次處理建立及管理整個最高成效廣告活動。 - 新增
BatchJobError.REQUEST_TOO_LARGE錯誤，用於提交大於 10,484,504 個位元組的AddBatchJobOperationsRequest。請將作業分成較小的群組，並以個別要求傳送。
- 新增使用
- 新增
Campaign.keyword_match_type，可為廣告活動中的所有關鍵字設定關鍵字比對類型。 AdService.getAd已移除，以便與 Google Ads API 中的其他服務保持一致。如需擷取資源的建議，請參閱「擷取物件」。- 在
AdGroupCriterion中新增primary_status和primary_status_reasons，指出廣告群組條件是否正在放送，或無法放送的原因。 - 新增報表
shopping_product，對應 Google Ads 使用者介面的「產品」頁面。 - 針對
ImageAdInfo.image_asset的尺寸和格式新增更多驗證，與 Google Ads API 中的其他圖片驗證更一致。 - 新增
segments.sk_ad_network_redistributed_fine_conversion_value，根據近期 SkAdNetwork 回傳資料的機器學習模型，將NULL值重新分配給其他值。 - 在 Google Ads API 中，所有資源的所有欄位、列舉和錯誤，探索一律更名為需求開發。
- 現在查詢
product_link時，只能選取與一個連結產品相關的欄位。否則會擲回QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE。 - 新增
UserListCustomerTypeService.MutateUserListCustomerTypes()，用於設定目標對象顧客類型。這個方法會取代CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings的使用。 - 新增兩個 expiration_date_time 欄位
local_services_verification_artifact，方便廣告主監控構件的到期時間。
在哪裡可以取得更多相關資訊？
下列資源可協助您踏出第一步：
如有任何疑問或需要其他協助，請透過論壇與我們聯絡。
- Thanet Knack Praneenararat (代表 Google Ads API 團隊)
標籤： google-ads-api、 release