Google Ads API Developer Assistant 2.0 版簡介

2026 年 2 月 26 日，星期四

這項重大更新讓助理從強大的程式碼生成工具，轉變為主動排解問題和自動化作業的夥伴，協助 Google Ads 開發人員。自 1.6.0 版發布以來，我們持續傾聽您的意見回饋，並著重於 API 開發中最具挑戰性的部分：診斷、一致性和設定。

2.0 版的新功能

1. 安裝與維護更簡單

設定多語言開發環境不應是件苦差事。

  • 單一指令設定：使用新的 --install-deps 旗標搭配 install.sh 或 install.ps1，一次處理 pip、composer 和 bundler 依附元件。
  • 統一目錄結構：所有產生的程式碼、匯出的 CSV 檔案和診斷報告，現在都集中在單一 saved/ 目錄下，並依輸出類型分門別類。
  • 單一指令更新：API 和用戶端程式庫推出新版本時，您需要執行 update.sh 才能使用最新版本。您也可以使用 update.sh 將其他用戶端程式庫新增至情境。

2. 代理轉換疑難排解

離線轉換追蹤是 Google Ads API 最強大但也最複雜的功能之一。找出轉換未歸因的原因，可能需要耗費大量時間手動偵錯。

在 2.0 版中，我們推出了專屬的轉換疑難排解和診斷套件。

  • 新指令碼：api_examples/collect_conversions_troubleshooting_data.py
  • 新指令：/conversions_support_data

指令碼會執行標準報表，排解轉換問題，並提供相關背景資訊，協助 Google 助理排解問題。

在 Google 助理分析並嘗試解決轉換問題後，這項指令最能發揮作用。如果無法解決，且您需要聯絡支援團隊，這項指令會分析顧客設定、轉換動作和上傳摘要，並根據已執行的分析產生結構化診斷報告。甚至能自動找出「不健康」狀態和高失敗率，省下數小時的記錄檔分析時間。並將結果儲存為文字檔。如有需要，您可以在提交支援要求時附上這個檔案。

3. 專為最新 API (v23) 打造

2.0 版完全支援 Google Ads API v23。我們已更新所有互動式範例，並針對最新資源和欄位最佳化助理的內部情境，確保生成的程式碼可部署於正式環境。

4. 透過工作階段掛鉤順暢自動化

我們新增了 SessionStart 和 SessionEnd 鉤子，讓工作流程更加順暢。

  • 自動設定：現在，助理可在工作階段開始時，自動在 $HOME 目錄中找出設定檔。並複製到專案目錄中的子目錄 config。Python 是 Gemini 查詢 API 的首選語言。因此，如果您使用其他語言，系統會讀取設定檔，並在設定中建立暫時的 google-ads.yaml 檔案來執行查詢，但仍會以您偏好的語言程式碼回應。
  • 自動清理：結束時，系統會安全地抹除暫時設定，保持工作區整潔，並確保憑證安全。

5. 更聰明的 GAQL 驗證

建構複雜的 GAQL 查詢比以往更輕鬆。我們已更新 GEMINI.md 和 conversions/GEMINI.md，針對最新的 API 邊緣案例制定嚴格的驗證規則，包括改善日期區隔和有限範圍要求的處理方式。現在，助理會在您執行查詢「之前」找出邏輯錯誤。

6. Skills

技能就像是迷你外掛程式或「行為藍圖」。雖然一般背景資訊 (例如 GEMINI.md 檔案) 會提供背景資訊，但只有在 AI 需要執行複雜的程序性工作 (例如取得這個擴充功能的目前版本) 時，才會將技能「載入」AI 的大腦。您不會直接執行技能，Gemini 會自行判斷何時需要。

雖然這項功能仍處於實驗階段，但我們已在本版本中加入一項功能，以補充我們使用掛鉤進行工作階段初始化和清理的做法。

為什麼要升級？

從 v1.6.0 升級至 v2.0.0 不僅是為了新功能，更是為了可靠性。v2.0 整合了深厚的 API 知識和自動化診斷工具，可減少「試誤」循環，避免 API 整合速度變慢。

無論是要排解轉換上傳問題，還是建構複雜的報表管道，2.0 版都能提供所需工具，讓您更快速、更有信心地完成工作。

開始使用

首次安裝

從舊版升級

  • 將 saved_code/ 和 saved_csv/ 中的任何自訂程式碼複製到安全的位置。
  • 刪除專案目錄和所有子目錄及檔案，即可刪除 Google Ads API Developer Assistant 的本機複製版本。
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • 在專案目錄中，執行 install.sh 或 install.ps1，安裝擴充功能和用戶端程式庫。

Bob Hancock，Google Ads API 團隊

標籤： google-ads-api、 release