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 的使用 Google 建構整合套裝組合之一。您可以在以下兩個位置啟用這項套裝組合，取得全域層級的存取權：

  • 首次使用期間：勾選 Google Ads API 堆疊的核取方塊。
  • 在「設定」中：
    1. 依序前往「設定」 >「自訂」。
    2. 在「使用 Google 外掛程式建構」下方，按一下「自訂」，然後點選「下載」，即可整合 Google Ads API。

如要使用專案層級存取權，請在專案目錄中執行下列指令：

npx skills add google/skills --agent=antigravity

Claude Code 

claude plugin marketplace add google/skills
claude plugin install google-ads@skills

Codex 

npx skills add google/skills

游標

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

其他代理程式

如要使用其他支援開放式 Agent Skills 標準的 AI 助理，可以透過 NPX 安裝技能：

npx skills add google/skills

更新 Google Ads API 代理商技能

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

Antigravity

透過「使用 Google 建立」啟用的整合功能，會由編輯器自動管理及更新。

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

npx skills update --all

Claude Code 

claude plugin update google-ads@skills

Codex 

npx skills update --all

游標

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-mcp-setup 協助設定及配置 Google Ads API Model Context Protocol (MCP) 伺服器，簡化本機環境中的驗證和設定。
google-ads-api-quickstart 逐步引導您設定開發人員環境、設定憑證，並對 Google Ads API 進行第一次 API 呼叫。

後續步驟