Google Ads API Developer Assistant 1.0 版隆重登場：使用自然語言與 API 互動

2025 年 12 月 10 日，星期三

Google Ads API Developer Assistant 正式推出！這項強大的 Gemini CLI 擴充功能，可簡化 Google Ads API 工作流程。這項工具可讓您使用日常語言與 Google Ads API 互動，輕鬆取得資訊、生成程式碼，甚至直接在終端機中擷取資料。
無論您是 Google Ads API 新手，還是經驗豐富的開發人員，這個助理都能協助您提高工作效率。

這項產品有什麼功能？

Google Ads API Developer Assistant (v1.0) 強化了 Gemini CLI，提供多項重要功能：

  1. 自然語言問答：對 Google Ads API 有疑問嗎？儘管開口問！
    • 「有哪些廣告活動類型？」
    • 「請說明最高成效廣告活動的報表功能。」
    • 「如何在 GAQL 中依日期篩選？」
  2. 自然語言生成程式碼：描述所需資料，助理就會生成 Google Ads 查詢語言 (GAQL) 和可執行的 Python 程式碼，並使用 google-ads-python 用戶端程式庫做為情境，確保程式碼符合最佳做法。
    • 「顯示過去 30 天內轉換次數最多的廣告活動。」
    • 「取得客戶『123-456-7890』的所有廣告群組。」
    • 「找出所有廣告活動中遭拒登的廣告。」
    • 產生的程式碼會自動儲存至 saved_code/ 目錄。
  3. 直接執行 API：直接從指令列執行生成的 Python 指令碼。助理會執行唯讀 API 呼叫並顯示結果，通常會以表格形式整齊地呈現在終端機中。
  4. 匯出 CSV：需要儲存資料嗎？您可以輕鬆將 API 呼叫的表格結果匯出為 CSV 檔案。只要說：
    • 「將結果儲存為 CSV 檔案」
    • 檔案會儲存在 saved_csv/ 目錄中。

運作方式

這項擴充功能會運用 Gemini CLI 的能力，使用 GEMINI.md 檔案中的脈絡和 .gemini/settings.json 中的設定。只要在助手中設定本機 google-ads-python 程式庫副本和範例目錄的路徑，就能生成相關且準確的程式碼。

開始使用

以下是開始使用前須完成的準備工作：
必要條件：

  • 熟悉 Google Ads API 概念和驗證。
  • Google Ads API 開發人員權杖。
  • 主目錄中已設定 google-ads.yaml 憑證檔案。
  • Python >= 3.10。
  • 已安裝 Gemini CLI。
  • google-ads-python 用戶端程式庫的本機副本。(設定指令碼可以為您複製這個存放區)。

如需詳細的設定操作說明和範例，請參閱 GitHub 存放區中的 README 檔案。

功能位置

Google Ads API Developer Assistant 可在 GitHub 取得。

社群與支援

歡迎試用！我們十分重視您的意見，歡迎填寫這份問卷調查。歡迎加入 Discord 的 #ads-api-ai-tools 頻道參與討論。

如要回報錯誤、建議功能或尋求支援，請使用存放區中的 GitHub Issues 分頁。請參閱 CONTRIBUTING.md 瞭解貢獻指南。

祝您一切順利！
Google Ads API 團隊 Bob Hancock

標籤： google-ads-api、 release