Google Ads API 第 23 版

2026 年 1 月 28 日星期三

我們今天宣布推出 Google Ads API 第 23 版。這是 2026 年的第一個版本，也代表我們開始加快發布頻率。

如要使用部分 v23 功能，您必須升級用戶端程式庫和用戶端程式碼。所有更新後的用戶端程式庫和程式碼範例都已發布。

以下是這個版本的一些重要功能：

• 啟用最高成效廣告活動的廣告聯播網類型細目。
• InvoiceService.ListInvoices 現在可在 Invoice 中傳回更精細的詳細資料，包括廣告活動層級費用明細、法規費用明細和調整項資訊。如要取得這些詳細資料，請在 ListInvoicesRequest 中設定 include_granular_level_invoice_details。
• 您現在可以為特定廣告活動類型指定開始和結束時間。新欄位 Campaign.start_date_time 和 Campaign.end_date_time 分別取代 Campaign.start_date 和 Campaign.end_date。
• PerStoreView 現已提供商店位置詳細資料。您可以透過 API 擷取「商店」報表中顯示的商店位置欄。
• 新增 LIFE_EVENT_USER_INTEREST 維度。這樣一來，使用者就能透過AudienceInsightsService和ContentCreatorInsightsService，使用人生大事建立目標對象。
• ReachPlanService.GenerateConversionRates 回應現在包含平台，可根據平台控制項 (例如 Gmail、Shorts) 提供不同的轉換率建議。這項功能僅適用於需求開發廣告活動。
• 新增 AudienceInsightsService.GenerateAudienceDefinition 方法，可讓您使用生成式 AI，將目標對象的任意文字說明轉譯為相符的目標對象屬性。
• ShoppingPerformanceView 現已支援新的競爭指標，以及按轉換日期區隔的轉換指標。

在哪裡可以取得更多相關資訊？

下列資源可協助您快速上手：

• 版本資訊
• 從舊版升級
• 指南
• 參考資料
• v23 和 v22 的差異

歡迎參加 1 月 29 日上午 11 點 (美東時間) 在 Discord 舉辦的 Google Ads API 版本重點活動，瞭解這個版本的詳細資訊。如有任何問題或想討論這篇文章，歡迎在 #ads-api 頻道與我們聯絡。

如有技術支援問題，請前往 https://support.google.com/google-ads/gethelp

 - Anash P. Oommen，Google Ads API 團隊

標籤： google-ads-api、 release