SuperAPI AI 工具集

google-ads

编程与开发

查看项目

更新于 10-16 09:48

技能介绍

用途:通过 Google Ads API 管理广告投放,包括报表查询、广告系列与广告组操作,以及受众和转化数据上传。

主要能力:使用 GAQL(类 SQL 语法)查询广告系列、广告组、广告、关键词等指标,支持 search 分页与 searchStream 大结果集;创建、更新广告系列和广告组;列出可访问账户;通过 Data Manager API 上传或移除受众成员、发送转化或事件数据并查询请求状态。

使用方式:先在 Zero 的 Settings → Connectors → Google Ads 连接。请求需 GOOGLE_ADS_TOKEN 与 GOOGLE_ADS_DEVELOPER_TOKEN;使用 MCC 时设置 GOOGLE_ADS_LOGIN_CUSTOMER_ID。请求头包含 Authorization: Bearer $GOOGLE_ADS_TOKEN、developer-token 与 login-customer-id。查询 POST 到 googleAds:search 或 googleAds:searchStream;变更 POST 到 campaigns:mutate、adGroups:mutate。Data Manager 调用使用 datamanager.googleapis.com,需 datamanager OAuth 范围,不使用 GAQL。

适用场景:广告效果报表、广告系列与广告组管理、受众上传与转化数据接入。

限制:客户 ID 不含连字符;cost_micros 为微货币单位,需除以 1,000,000;新建广告系列和广告组应先设为 PAUSED;激活或修改在线广告系列前需用户确认;超过 10,000 行用 searchStream;search 单页上限 10,000,用 next_page_token 分页;Data Manager 上传需用户确认同意、目标账户归属及是否 validateOnly,标识符需规范化并 SHA-256 哈希,编码用 HEX。故障排查可用 zero doctor check-connector 命令。