隆重推出 Google Ads API Developer Assistant 3.0.0 版

2026 年 6 月 10 日，星期三

我們很高興宣布推出 Google Ads API Developer Assistant 3.0.0 版。這個重大版本是 Google 助理發展的重要里程碑，著重於架構現代化、提升可靠性，以及更模組化的設計。

在這個版本中，我們會將助理遷移至 Google Antigravity 代理程式架構，並轉換至技能型架構。這些變更可讓助理更強大、更容易維護，並減少權杖用量。

3.0.0 版新功能

1. 採用 Antigravity 架構

Google Ads API Developer Assistant 已從 gemini-cli 遷移至 Antigravity 代理程式架構 (3.0.0 版)。這項基礎架構升級可提供更結構化且可靠的執行環境。此外，專案的目錄和檔案結構也已更新，可完全支援 Antigravity。

gemini-cli 的支援服務將於 2026 年 6 月 18 日終止，詳情請參閱這篇 Google 網誌公告。

2. 模組化、技能導向的架構

我們已將 Google 助理的核心功能轉換為技能。現在，助理不再依賴脈絡檔案中廣泛、非結構化的指令，而是會在需要時，動態載入經過測試的專門工具目錄 (技能)。這能大幅減少「幻覺」現象，確保工作按照精確、經過驗證的程序執行。

這項模組化轉換作業的主要更新包括：

  • GAQL 驗證 (validate_gaql)：已移至專屬技能。現在，這項功能會針對日期區隔、click_view 單日篩選器和 change_status 邊界，執行更完善的靜態查詢檢查。
  • 排解轉換問題 (troubleshoot_conversions)：取代舊的 conversions_support_package。這項認證將所有轉換疑難排解、上傳摘要指令碼和測試，整合為單一且連貫的技能目錄。
  • 結構化指令 (explain 和 step_by_step)：轉換為技能，強制採用一致的結構化版面配置來提供說明。
  • 新帳戶對應 (get_cids_under_mcc)：新技能，可擷取管理員帳戶 (我的客戶中心) 下的所有子帳戶。
  • 新物件檢查 (inspect_object)：這項新技能可動態查詢 Protobuf 訊息和列舉，確保 Google 助理一律使用正確的結構。
  • 新最高成效廣告活動商家資訊篩選器 (pmax_listing_filter)：新技能，可標準化最高成效廣告活動的商家資訊群組網頁排除樹狀結構修改。

3. 更一致、更嚴謹

我們制定了更嚴格的規則和要求，確保程式碼生成和查詢驗證品質：

  • 明確的 API 版本管理：get_cids_under_mcc、validate_gaql 和 troubleshoot_conversions 等重要技能現在需要明確的 api_version 引數，避免混淆。
  • 嚴格的 GAQL 規則：
    • 在 AGENTS.md 中新增規則，禁止在 GAQL 查詢中使用 SQL 匯總函式 (例如 SUM、COUNT 和 AVG)，因為系統不支援這類函式。
    • 新增規則，先查看 Google Ads API 開發人員網站版本資訊，確認目前的 API 版本，確保 Google Ads 助理使用最新說明文件。
    • 簡化設定：AGENTS.md 經過簡化，初始脈絡窗口較小。重複的轉換說明文件已移除，改為程式輔助技能。

4. 開發人員體驗 (DX) 改善

我們進行了多項生活品質改善，讓開發循環更快速流暢：

  • 永久虛擬環境 (.venv)：虛擬環境不會在工作階段結束時刪除。啟動時，小幫手會檢查系統的 Python 版本，只有在有較新的 Python 版本時，才會重建 .venv。
  • 智慧型 API 版本快取：Google Ads 助理現在會快取目前的 Google Ads API 版本，存留時間為 19 小時，可避免重複的網路檢查，縮短啟動時間。
  • 使用永久記錄，更輕鬆地偵錯：記錄訊息現在包含日期時間戳記。記錄檔會寫入 .agents/ 目錄，且不會在每次執行時重設，以便保留記錄供疑難排解。

為什麼要升級？

升級至 3.0.0 版主要是為了提升穩定性和改善結構。改用 Antigravity 架構並將功能模組化為「技能」後，Google 助理的行為變得更可預測，資源效率也更高。

如要加快啟動速度、提高 GAQL 驗證可靠性，以及更完善的疑難排解體驗，建議升級至 3.0.0 版。

開始使用

首次安裝

  1. 安裝 Antigravity CLI：請按照 https://antigravity.google/ 的操作說明操作。
  2. 複製助理： 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. 執行安裝指令碼：
    • Linux/macOS：執行 ./install.sh (預設支援 Python，如需其他語言，請使用 --php 或 --ruby 等旗標)。
    • Windows：開啟 PowerShell 並執行 .\install.ps1。

從 v2.x 升級

  1. 將 saved/ 中的任何自訂程式碼或資料，複製到專案目錄外的安全位置。
  2. 刪除 Assistant 的本機複製。
  3. 複製存放區：
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. 執行安裝指令碼 (install.sh 或 install.ps1)，初始化新的 Antigravity 環境。

Google Ads API 團隊 Bob Hancock

標籤： google-ads-api、 release