2026 年 8 月 25 日，星期二
Google Ads API 開發人員助理推出重大更新。這個版本將助理從獨立專案設定，轉換為統一的外掛程式架構，旨在將專門的 Google Ads API 功能直接導入 AI 代理工作流程。
這是什麼？
Google Ads API Developer Assistant 可將 Google Ads 領域的專業知識，帶入 Antigravity 和 Claude Code 等 AI 程式設計環境。為 AI 助理提供專用工具和防護機制。函式包括：
- 生成慣用程式碼：建立經過測試、符合最佳做法的整合代碼，適用於 Python、Java、PHP、.NET 和 Ruby。
- 驗證 GAQL 查詢：在執行查詢前，自動驗證語法、欄位相容性、日期區隔和零曝光規則。
- 檢查 Protobuf 結構定義：隨選探索任何有效 Google Ads API 版本的資源欄位、資料類型和列舉定義，確保 GAQL 查詢欄位有效。
- 排解 API 問題：診斷離線轉換上傳失敗、瀏覽管理員帳戶階層，以及建構最高成效廣告活動商家資訊篩選器。您可以用自然語言提問，例如「顯示帳戶中所有有問題的廣告，並建議修正方式」。
- 回答 API 問題：助理會結合內嵌的 Google Ads API 架構規則，以及動態本機 Protobuf 結構定義檢查，回答問題，提供版本準確的指引和經過驗證的程式碼片段。這項功能會直接根據官方 API 定義和用戶端程式庫原始碼生成回覆，而非僅仰賴一般模型訓練。例如「什麼是共用組合？如何使用？」
- 臨時報表：您可以使用一般英文要求成效資料，助理會立即建構、驗證及執行必要的 GAQL 查詢，直接從 Google Ads 帳戶擷取資料。並將即時結果以乾淨、格式化的表格形式傳回對話，讓您輕鬆製作臨時報表和調查指標。如要儲存結果，請要求 Gemini「將結果儲存為 CSV 檔案，並存放在 <你的目錄>」，然後將檔案載入試算表進行分析。
支援 Antigravity 和 Claude Code
這個版本推出雙平台支援：
- Antigravity：原生支援 Antigravity 開發環境，可註冊全域和工作區外掛程式。
- Claude Code：與 Claude Code CLI 外掛程式系統完全整合，包括自訂斜線指令 (例如
/validate-gaql、/inspect-object、/troubleshoot-conversions和/get-cids)。
Linux、macOS (bash) 和 Windows (PowerShell) 均提供統一的安裝指令碼，可在這三個平台上提供一致的生命週期管理。
提高效能
- 減少詞元消耗：漸進式揭露規則和結構定義，只載入特定工作所需的脈絡，減少提示詞元負擔。
- 縮短回應時間：隨選執行技能，並將指令轉送至指定目標，加快端對端工作完成速度。
- 降低 CPU 使用率：簡化執行管道，消除開發工作階段期間的背景程序負擔。
- 減少磁碟 I/O：減少外掛程式樹狀結構中不必要的檔案數量，可避免檔案監控工具、linter 和 IDE 索引工具掃描數萬個未使用的 protobuf/SDK 檔案。
- 降低記憶體 (RAM) 占用量，且不耗用 Daemon 資源：現在，技能和指令只會在呼叫時，以快速子程序的形式暫時執行，閒置時不會耗用系統資源。
- 快取 API 版本和 Protobuf 結構定義解析：檢查標準欄位、資源和列舉時，助理會避免重複發出遠端中繼資料或反射 API 呼叫。
- 確定性指令執行與多輪 LLM 推論：本機驗證器會一次檢查欄位、資源、零曝光指標和日期子句，而不是讓 LLM 猜測或反覆偵錯 GAQL 語法，來回 3 到 4 次。
採用現代化外掛程式架構的重大版本
這是重大版本，與先前版本不相容。早期版本仰賴本機工作區專案結構。這個版本是以標準化外掛程式架構建構而成，安裝後即可在全球使用。
將規則、技能和診斷指令模組化，整合成獨立的外掛程式套件，開發人員就能在多個環境和專案中安裝、更新及管理助理。
如需外掛程式架構的技術詳細資料，請參閱 README.md。
開始使用
由於這個版本的架構有所變更，請先詳閱說明文件再安裝：
- 請參閱 README_BEFORE_INSTALLATION.md，瞭解必要條件和環境準備工作。
- 按照 README.md 中的安裝操作說明進行。
我們需要你的意見回饋
歡迎使用問卷調查表單提供意見、回報問題及建議功能：
👉 提交意見回饋
標籤： google-ads-api、 release