SuperAPI AI 工具集

google-ads

营销与增长

查看项目

更新于 10-16 00:21

技能介绍

用途:通过智能体调用工具操作 Google Ads 账号,读取走 GAQL 搜索端点,写入走各资源 mutate 端点,共 13 个工具,覆盖账号导航、读取与报表、活动/预算/转化跟踪管理。Google Ads 账号为层级结构,管理(MCC)账号可操作其下客户账号;多数工具需操作账号 customerId,经管理账号访问时另需 loginCustomerId。

主要能力:解析可访问账号及管理账号下的客户账号;列出或 GAQL 查询活动、广告组、广告(含状态、预算、日期);按资源+指标+日期区间构建效果报表;暂停/启用/移除活动;创建或调整每日预算;列出或创建转化操作(含离线转化 UPLOAD_CLICKS)。

使用方式:作为 agentskills.io 技能,可先用 npx skills add zapier/connectors --skill google-ads 安装,再在本地运行前执行一次 npm install --omit=dev;需 Node.js 22.18+。按运行形态加载对应参考:MCP 客户端、终端/子进程、SDK 依赖导入或直接调用 API。调用脚本前先运行 --help 查看输入契约,勿猜测字段名与类型。认证通过连接选择器传入,格式为 [<resolver>:]<value>,支持 zapier:<connection-id> 及连接器自身的直连令牌解析器。

限制:金额以 micros 计(1,000,000×货币金额,转化操作默认值为普通货币);写入需用 id 而非名称,重名活动应先确认;不支持上传离线转化、添加 Customer Match 成员,也不创建完整活动或管理关键词/定位/广告创意;输出为 { data, meta } 信封,可跳过输出校验或使用 jq 过滤,输入校验不可跳过。其余细节暂未提供。