2026 年 4 月 22 日，星期三
今天，我們宣布推出 Google Ads API v24。如要使用 v24 的新功能，請務必升級用戶端程式庫和用戶端程式碼。所有更新後的用戶端程式庫和程式碼範例都已發布。
歡迎參加明天 (4 月 23 日上午 10 點，美東時間) 的 Discord「Google Ads API 版本重點」活動、Ads 開發人員 YouTube Live 或 LinkedIn Live 活動，我們將在活動中逐步介紹這個版本。我們也會錄製活動內容並發布到 YouTube，方便無法參加現場直播的使用者觀看。如有任何疑問或想討論這篇文章，歡迎透過 Discord 的 #ads-api 頻道與我們聯絡。
新功能
支援「透過購物車資料回報的轉換」：「透過購物車資料回報的轉換」是網站或應用程式轉換追蹤的擴充功能，可提供每筆交易的售出產品詳細資料，協助您根據 Google Ads 帳戶和廣告活動，產生相關的進階銷售、利潤報表和洞察資料，例如訂單數、平均購物車內商品數量、收益和毛利。
Google Ads API v24 新增對這項功能的支援，如下所示：
- 新增資源
CartDataSalesView，可依產品點擊和售出的產品，使用product_sold_brand等區隔劃分轉換指標。這樣一來，廣告主就能查看顧客點按廣告後實際購買的產品統計資料，即使廣告宣傳的是其他產品也沒問題。 - 新增多個「所有」非可出價指標，這些指標也包含廣告活動未主動爭取的轉換，例如
all_cost_of_goods_sold_micros。新指標會新增至支援對應可出價指標的所有資源。 - 在
ShoppingPerformanceView資源中新增conversion_attribution_event_type區隔，以便與購物車資料和其他轉換指標一併選取。這個區隔會指出轉換是歸因於點擊還是瀏覽，且必須辨識瀏覽後轉換產生的購物車資料統計資料。
更新功能
v24 版更新了現有功能，升級時需要變更程式碼。本文將介紹最重要的幾項功能，如需完整的異動清單，請參閱版本資訊。
廣告活動的影片內容排除設定：我們簡化了個別廣告活動的影片內容排除設定。這項設定位於客戶層級，會套用至所有廣告活動。這些內容排除設定旨在協助您進一步控管廣告，排除雖符合政策但不適合您品牌或業務的內容類型。如要進一步瞭解影片內容排除設定，請參閱 https://support.google.com/google-ads/answer/7515513。
AudienceInsightsService 異動：我們在重構程式碼時，將 InsightsAudience.topic_audience_combinations 要求欄位移至 common 命名空間。在某些程式設計語言中，您可能需要更新匯入指令。
ReachPlanService 異動：為了重構程式碼，我們將 youtube_select_lineups 欄位從 ReachPlanService.ListPlannableProducts 服務中移除。youtube_select_lineup_targeting 欄位現已提供首選頻道。YouTube Select 首選頻道是預訂產品，符合資格的客戶可指定特定市場中最熱門的前 1% YouTube 頻道，觸及這些頻道最忠實的觀眾。瞭解詳情。
ContentCreatorInsightsService 異動：為重構程式碼，我們從 ContentCreatorInsightsService.GenerateCreatorInsights 和 ContentCreatorInsightsService.GenerateTrendingInsights 服務中移除 is_brand_connect_creator 欄位。
使用者應改為尋找創作者，才能在 partnership_opportunities 中使用 CREATOR_PARTNERSHIPS 選項。Google Ads 的 YouTube 創作者合作計畫可讓您尋找 YouTube 創作者共同製作贊助商內容，並有效管理創作者合作事宜。瞭解詳情。
KeywordPlanIdeaService 異動：為提供更流暢可靠的體驗，我們已整合預測基礎架構。Google Ads API 24 版推出更新版 GenerateKeywordForecastMetrics 方法，著重於對成效影響最直接的指標，簡化規劃程序。我們會在未來幾天內發布更詳細的網誌文章，說明這項異動。
campaign_budget 資源異動：我們移除了 campaign_budget 資源的 ad_sub_network_type 區隔，因為該區隔與這個檢視不相容。
素材資源檢視畫面異動：我們已從 ad_group_asset、campaign_asset 和 customer_asset 檢視畫面中移除 click_type 區隔。這項異動是為了配合最近的產品異動，從 Google Ads 中移除這個區隔，避免資料不實。您可以使用 ad_group_ad 資源中的 click_type 區隔，取得廣告成效和廣告素材資源的詳細資料。
影片回應式廣告變更：VideoResponsiveAdInfo現在可變更。在本次異動中，我們已將 videos、business_name 和 logo_images 標示為 DemandGenVideoResponsiveAdInfo 和 VideoResponsiveAdInfo 物件中的必填欄位。
ShareablePreviewService 異動：更新 ShareablePreviewService.GenerateShareablePreviews，不再使用部分失敗。如果任何 ID 失敗，要求就會擲回錯誤。瞭解詳情。
下列資源可協助您快速上手：
如有技術支援問題，請前往 https://support.google.com/google-ads/contact/google_ads_api
- Anash P. Oommen，Google Ads API 團隊
標籤： google-ads-api、 release