Google Ads API 代理商技能

Google Ads API 代理技能是可攜式、獨立的模組，包含 Google Ads API 專屬知識、指令和工作流程。Google Ads API 代理技能可與支援開放式代理技能標準的 AI 助理搭配使用，包括 Google Antigravity 和 Claude Code。

這些代理技能可協助 AI 助理掌握 Google Ads API 最佳做法、設定工具，並提高工作流程的執行準確度，同時降低詞元成本。如需可用技能清單，請參閱「可用技能」。

開始使用

安裝適合開發環境的代理技能。

安裝 Google Ads API 代理技能

在多數情況下，您可以使用單一指令，在偏好的編輯器中安裝 Google Ads API 代理程式技能：

Antigravity

Google Ads API 代理技能是 Antigravity 的 Build with Google 整合套件之一。您可以在兩個位置啟用這個套件，授予全域層級存取權：

  • 新手上路期間：勾選 Google Ads API 堆疊的核取方塊。
  • 在「設定」中：
    1. 依序前往「設定」 >「自訂」。
    2. 在「Build with Google Plugins」下方，按一下「Customize」，然後點選「Download」，下載 Google Ads API 整合。

如果您偏好專案層級存取權，請在專案目錄中執行下列指令：

npx skills add google/skills/skills/ads --agent=antigravity

Claude Code 

npx skills add google/skills/skills/ads --agent=claude-code

Codex 

npx skills add google/skills/skills/ads --agent=codex

Cursor

如要直接安裝 Google Ads API 代理技能，請在編輯器設定的自訂規則中，新增技能的 GitHub 存放區端點 (例如 https://github.com/google/skills)。詳情請參閱 Cursor 說明文件，瞭解如何從 GitHub 安裝技能。

您也可以使用 npx 安裝技能 (需要 Node.js)：

npx skills add google/skills/skills/ads --agent=cursor

其他代理

如果其他 AI 助理支援開放式代理技能標準，您可以使用 npx 安裝技能 (需要 Node.js)：

npx skills add google/skills/skills/ads

更新 Google Ads API 代理技能

您可以執行 update 指令，取得所有可用的更新，並清除過時的技能：

Antigravity

透過 Build with Google 啟用的整合功能，會由編輯器自動管理及更新。

如果您使用 npx 指令安裝代理技能，可以執行 update 指令，取得所有可用的更新：

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

Cursor 

npx skills update --all

其他代理

如果是其他支援開放式 Agent Skills 標準的 AI 助理，您可以使用 npx 更新所有有效技能：

npx skills update --all

使用 Google Ads API 代理技能

只要偵測到技能說明與目前要求相符，AI 助理就會自動使用該技能。除非提示內容與 Google Ads API 工作相符，否則全域安裝的技能在不相關的專案中會保持休眠狀態。

您也可以在代理對話中輸入 / 並搜尋技能名稱，手動叫用技能。

技能的核心要素

每項代理技能都是專門的套件，可為 AI 助理提供下列元件：

  • 特殊指令：在脈絡窗口中插入詳細的提示指令，引導助理生成 GAQL 查詢、設定 OAuth 憑證，以及處理常見錯誤代碼。
  • 最佳做法：Google Ads API 開發人員關係團隊定義的標準效能、安全性和整合建議。
  • 自動化指令碼：技能套件中包含的可執行指令碼 (例如用於環境驗證或工作區設定)，可在本機執行工作。

使用技能的好處

代理技能可視需要提供專業知識，擴充助理的功能，不必在每段對話中載入龐大的指令，造成額外負擔。

降低權杖成本

傳統 AI 整合通常會預先載入大量文件，耗用大量詞元並增加工作階段成本。代理技能會使用漸進式揭露，盡可能減少這項負擔：

  • AI 助理一開始只會檢查技能的名稱和說明，判斷是否與要求相關。
  • 只有在助理判斷特定工作需要時，才會將技能的完整指示和參考資料加入使用中的脈絡窗口，節省脈絡空間。

AI 引導導入

您不必手動搜尋說明文件，只要用自然語言描述意圖，技能可引導 AI 助理執行下列工作：

  • 生成 GAQL 查詢，從我的帳戶擷取廣告活動成效指標。
  • 使用用戶端程式庫編寫 Python 指令碼，建立新的廣告活動。
  • 使用 Google Ads API 擷取廣告活動轉換和診斷資料。

如需可用技能的完整清單，請參閱「可用技能」。

搭配 Google Ads API MCP 伺服器使用技能

代理技能旨在與 Google Ads API Model Context Protocol (MCP) 伺服器搭配使用：

  • Google Ads API MCP 伺服器：專為 AI 輔助開發工作流程設計，可讓 AI 助理透過程式輔助方式，與 Google Ads API 資源、廣告活動和指標互動。
  • Google Ads API 代理技能：提供提示指令和建議做法，引導助理透過漸進式揭露，以節省權杖的方式執行工作。指示代理如何有效使用 MCP 伺服器和用戶端程式庫等工具。

可用的技能

Google Ads API 團隊提供一系列技能，協助您使用 Google Ads API 建構：

技能 說明
google-ads-api-account-diagnostics 使用 Google Ads API MCP 伺服器，診斷 Google Ads 帳戶效能問題，例如轉換損失、待開發客戶數量偏低，以及因廣告評級、出價或預算而錯失的曝光比重。
google-ads-api-mcp-setup 協助設定 Google Ads API Model Context Protocol (MCP) 伺服器，簡化本機環境的驗證和設定程序。
google-ads-api-quickstart 引導您設定開發人員環境、設定憑證，以及對 Google Ads API 進行首次 API 呼叫。

後續步驟