# Google Ads API 与 Meta Ads API：你自己的广告系列数据

你正在投放的广告系列的花费、展示次数、点击次数和转化次数，由 鹦鹉AI 通过 鹦鹉AI 从已连接的广告账号读取。连接一次，令牌留在服务端，agent 始终看不到它。本页背后的调研表明，真正的障碍从来不是接口本身，而是如何在接口前放上一份可用的凭证。

## 怎么让 鹦鹉AI 做这件事？

安装行（粘到任意 agent）：`set up 鹦鹉AI — https://parrot.amorist.cn/llms.txt`

然后说：「使用 鹦鹉AI，拉取我 Google Ads 和 Meta Ads 账户中每个广告系列上个月的花费、展示次数、点击次数和转化次数，然后告诉我：以每次转化 $40 为目标，哪三个广告系列亏得最多。」

- **指明时间窗口** 两者都接受明确的范围。要「上个月」，你拿到的就是上个月，而不是从开始到现在的全部。
- **在一轮里同时要两边** 它们是两次调用，不是两段对话。一轮就能拿到一张可以对比的表。
- **说明要哪个层级** Meta 可以按账户、广告系列、广告组或广告层级返回。选一个，否则合计数的含义可能和你想的不一样。
- **说明这个答案用来做什么** 「亏钱」是判断，不是一个字段。把阈值给它，它就会把算术做掉。

## 为什么走鹦鹉AI

- **不订阅，不买席位** 按次计费。不用绑卡、没有最低消费；给预付余额充值即可。
- **换个工具只是换一个词** 提示词里换一个词就是另一款工具，而不是一次新的集成。

端点：

- `google-ads.x.gaql-campaign` — 通过 GAQL 查询 Google Ads 广告系列数据 (google-ads): https://parrot.amorist.cn/catalog/google-ads
- `meta-ads.insights` — Meta 广告的花费、展示、点击与转化 (meta-ads): https://parrot.amorist.cn/catalog/meta-ads

## 大家实际卡在哪

来自 2026 年 8 月阅读的 82 条 Reddit 和 X 帖子，其中 17 条既切题又是自然讨论。我们剔除了 43 条，包括一个把同一份「用 Claude Code 搭建」引流内容发了十八次的 X 账号。有人说这里的痛点是 GAQL 学习曲线和速率限制，但这两个主题完全没有自然讨论的帖子，所以本页不把它们算作问题。

**挡路的是凭据，不是接口**

> "测试用的开发者 token 只能访问白名单里的账号。在依赖它之前，先升级到标准访问权限。" (r/PPC, 50 points: https://www.reddit.com/r/PPC/comments/1ubluzq/i_got_tired_of_logging_into_google_ads_every/)

这一页能帮上的： 这是调研里最大的一个主题，也是 鹦鹉AI 真正改变了形态的一件事：凭据在服务端注入，所以它永远到不了你的 agent、你的提示词或你的代码仓库。也要说清楚它做不到什么。它不会给你你本来没有的权限；一个只能看到白名单账号的 token，经由这里调用时依然只能看到白名单账号。

**Meta 可以把你关掉，还不告诉你为什么**

> "我一直在试着通过 MCP 连接器把我的 Meta Ads 账号连到 Claude，完全卡住了。" (r/FacebookAds, 7 points: https://www.reddit.com/r/FacebookAds/comments/1t01u3w/meta_ads_mcp_connector_is_ads_mcp_enabled_false/)

这一页能帮上的： 值得说准确一点，因为那位读者的问题是 Meta 自己连接器上线过程中的一个特定开关，而不是 Marketing API。这一页上的那一行是普通 insights 接口，作用在你已连接的广告账号上，所以那个开关不在它的路径里。Meta 之外没人能告诉你，为什么同一个权限在一个资产组合里关着、在另一个里开着，任何代理也无法让这件事变得看得懂。

**一个账号是周末项目，二十个客户就是一个产品**

> "我需要安全地从多个客户账号拉数据，每个账号都有自己的凭据和权限。" (r/claude, 2 points: https://www.reddit.com/r/claude/comments/1t3ynsq/looking_for_developer_to_build_multi_client_api/)

这一页能帮上的： 那是一条付费招聘帖，这是调研里“这是真正的工作、不是小麻烦”最有力的证据。为每个连接持有一份凭据、并把它挡在 agent 之外，正是注册表存在的意义。至于某一轮里 agent 可以读哪个客户，仍然要由你来设计，这一页不会假装不是这样。

**agent 会满怀信心地把数字编出来**

> "我唯一能信它的时候，是它跑脚本并把输出存下来的时候。" (r/PPC, 83 points: https://www.reddit.com/r/PPC/comments/1sy40pq/my_experience_using_claude_code_codex_to_actually/)

这一页能帮上的： 没有好答案，谁说有就是在向你推销。这里没有任何东西能阻止模型编一个数字。有两件事确实有帮助，而且都很小：平台自己的响应被原样转达，而不是被中间一层重新塑形；每次调用都记在账上，所以答案里的那个数字对应着一次你能指出来的调用。拿总数去跟平台自己的看板对一遍，仍然值得花那三十秒。

**数字会在你脚下挪动，而且不会停**

> "Meta 在 Facebook Graph API 里弃用了 Reach，各处看板都在崩。" (r/GoogleDataStudio, 6 points: https://www.reddit.com/r/GoogleDataStudio/comments/1uv8e3n/meta_deprecated_reach_in_the_facebook_graph_api/)

这一页能帮上的： 诚实的回答是：这恰恰不是修复。鹦鹉AI 从不对上游 API 做建模，它原样转达响应，所以一个被弃用的字段就以被弃用的字段的样子到达你这里，而不是被某个映射层悄悄返回一个过期的东西。你能更快发现，而且发现的是真相。没有哪个页面能告诉你 Meta 下一个弃用什么。

## 真正不一样的地方

- 两条路径都有配额限制。Google Ads 把请求计入开发者令牌的每日操作上限。Meta 的 insights 调用会消耗该广告账号的速率限制预算，细分维度越宽消耗越快，所以只要求你真正会看的那种拆分。
- 两个服务要求的请求形态不同。Google Ads 针对客户 ID 执行一条查询，所以字段、指标和日期范围都写在同一段字符串里。Meta 把广告账号放在路径中，其余都作为参数：fields、日期预设或明确范围、层级、可选的按天增量以及细分维度。这两种请求都由你的 agent 来写，而层级正是「错误答案看起来像正确答案」的地方。
- 这两行只读取，不修改。本页背后的能力是广告系列表现与 insights，所以指向它们的 agent 可以报告预算，但不能修改预算。如果你想要一个还能修改广告系列的 agent，那是另一组能力，需要单独、明确地做决定。

## 这两个 API 到底返回什么？

各自服务的报表接口，而不是仪表盘的副本。Google Ads 会执行你针对某个客户账号编写的查询，返回你在指定日期范围内点名的广告系列字段和指标。Meta 则在某个广告账号上作答，按你要求的层级返回花费、展示次数、点击次数和转化次数，并可选按天拆分或按细分维度拆分。两者都是对你已拥有账号的读取路径。

## 开始之前

**会返回哪些数字？** 至少包括花费、展示次数、点击次数和转化次数。Meta 可以按天以及你要求的细分维度拆分，层级可选账户、广告系列、广告组或广告。Google Ads 返回你的查询点名的广告系列字段和指标，所以结构由你选择，而不是固定的。

**agent 能改动我的广告系列吗？** 不能通过本页做到。它背后的两项能力都是读取路径，所以 agent 在这里最糟糕的结果无非是读错数字。修改预算或暂停广告是另一项能力，需要你有意去请求。

HTML 版本： https://parrot.amorist.cn/use-cases/your-own-campaign-performance