← 返回入门指南   ← 返回 API 参考文档

⚠️ 错误代码

更新时间：2026年6月16日

以下是 Marketing API 返回的错误代码。

重要提示：应仅使用错误代码进行错误处理。描述字符串如有更改，恕不另行通知。

错误代码是整数，通常带有子代码（error_subcode）以实现更细粒度的错误识别。负值错误代码表示 Facebook 内部错误，请查看 error_subcode 获取实际失败代码。

blame_field_specs 数组包含在验证错误的 error_data 中，用于指明导致验证错误的字段。

blame_field_specs

blame_field_specs 是包含在 error_data 中的属性，指明哪个字段触发了验证错误。可用于在 GUI 的相应字段旁显示错误信息。

单一字段错误示例：

{
  "error": {
    "type": "Exception",
    "message": "The budget for your Ad-Set is too low.",
    "code": 1487901,
    "error_data": {
      "blame_field_specs": [
        ["daily_budget"]
      ]
    }
  }
}

多字段错误示例：

"blame_field_specs": [
  ["targeting_spec", "interested_in"],
  ["bid_info", "impressions"]
]

表示 targeting_spec 中的 interested_in 子字段和 bid_info 中的 impressions 字段都有问题。

🔐 认证、权限与令牌错误

代码子代码描述
10—应用程序没有此操作的权限。
102—会话密钥无效或不再有效。
104—签名错误。
190—OAuth 2.0 访问口令无效。
200—权限错误。
2001870034不接受自定义受众条款。需同意条款才能创建或编辑受众或广告组。
2001870047受众规模过小：无法从此受众中移除用户，会导致投放不足。
294—管理广告需要扩展权限 ads_management 和白名单应用。
26541713092对此广告账户没有写入权限。开发者必须有广告账户权限才能为其创建受众。
1404163—广告账户已被永久限制投放广告。
了解更多
1815694—用户没有此操作的权限。
2708008—未获得投放社会问题、选举或政治广告的授权。需完成身份确认流程。

⏱️ 速率限制错误

代码描述
4应用请求达到上限。
17用户请求数量已达上限。
1404078你已被暂时阻止执行此操作。
2859015你已被暂时阻止执行此操作。

⚙️ 无效参数与配置错误（Code 100 系列）

代码子代码描述
1—发生未知错误。
199未知错误。如果 level 设置为 adset 但正确值应为 campaign，可能出现此错误。
100—无效参数。
10033不支持的 POST 请求。访问口令未以具有适当权限的系统用户添加到拥有自定义受众的广告账户。需在 Meta Business Suite 中验证。
1001487694无效参数——所选类别不再可用。使用 Targeting Search 查看可用类别。
1001752129无效参数——不支持此任务组合。传入映射中定义的有效任务组合。
1003858258图片未下载。确保图片可通过互联网访问且未被 robots.txt 屏蔽。
2606—无法显示此广告的预览。
2607—指定货币对广告无效。
2615—对此广告账户的更新调用无效。
5000—未知错误代码。

🔄 广告系列 / 广告组 / 广告生命周期错误

代码描述
1340029不允许删除动态创意广告。请删除父广告组。
1373054无法解析行动号召类型。请参考行动号召 API 文档。
1487007无法编辑此广告——它属于已到达结束日期的排期广告组。请更改结束日期为将来时间。
1487033广告系列结束日期必须为将来时间。
1487056此广告组已删除，只能编辑名称。如需编辑其他字段，请复制广告组。
1487472{msg} 无法在广告中推广。请选择其他公共主页帖子。
1487566广告系列已删除，只能编辑名称。复制后可编辑其他字段。
1487678应用的操作系统与广告组定位设置不匹配。
1487831无法加载商品系列——可能不存在或因隐私原因无法访问。
1487929推广对象不明确。只能指定一个推广对象。
1487990此广告账户已归档太多广告组。需删除部分广告组后才能继续归档。
1815199广告账户无权访问此 Instagram 账户。
1815629所有广告资产值应唯一。请检查你的值。
1885029为广告选择的公共主页与推广对象关联的公共主页不匹配。
1885088广告已归档，只能编辑名称。复制后可编辑其他字段。
1885183广告创意帖子由开发模式下的应用创建。应用必须为公开状态。
1885204要使用所选优化目标，请将出价设为自动（移除手动出价）。
1885272预算过低。
1885557广告推广的帖子不可用——已删除、未发布或不属于广告的公共主页。
1885621不能同时设置广告组预算和广告系列预算，只能使用其一。
1885650预算过低——最低金额需考虑最多 15 分钟的支出延迟。
2446150不能同时传递 instagram_user_id 和 instagram_actor_id。
2446289所选 {post_type} 不可用——可能已删除或只能通过 UI 完成。
2446383广告系列目标需要外部网站 URL。请在广告创意中选择行动号召并输入网站 URL。
2446394广告组包含的细分定位选项不再可用。
2446509广告系列目标位置类型无效。
2446580在提供 interactive_components_spec 参数时不能同时指定组件和 child_attachments 字段。
2446712不能再使用门店访问量优化目标创建或运行广告组。请改用覆盖人数或门店销量优化。
2446867已达到 Advantage+ 购物广告系列的国家数量上限。
2446880连接到 Facebook 公共主页或 Instagram 个人主页的 WhatsApp 号码已断开连接。
2490085191x100 裁剪键在最新 Ads API 版本中不再可用。推荐使用 100x100。
2490155与广告关联的帖子不可用——可能已被删除或你没有查看权限。
2490372需要选择店铺目标位置才能继续。
2490427广告在最新审核中被拒，目前处于禁用状态。需修改后创建新广告。
2490468广告在最新审核中被拒，目前处于禁用状态。需修改后创建新广告。
3858064广告系列包含不再适用于 18 岁以下受众的选项。
3858082创意符合标准增强条件，但未提供 enroll_status。
3858152广告所属广告组必须发布受益人和付款人信息。
3867105此内容不能用于合作广告。请选择其他内容。
3910001账户遇到一些问题，请稍后重试。

🎯 定位与受众错误

代码子代码描述
1870065—不能使用此内容，因为它包含至少一个已被禁用的受众。已禁用的受众由不再活跃的账户共享。需移除受影响的受众。
1870088—关联定位正在弃用。请从广告系列中移除关联设置。
1870090—要创建或编辑受众或广告组，请同意自定义受众条款。
1870092—要创建或编辑受众或广告组，请同意 Meta 商业工具条款。
1870165—受众包含的定位选项不能用于定位 18 岁以下用户。请提高最低年龄限制或移除相关定位。
1870199—所有位置定位将覆盖"居住在或近期到过"所选位置的用户。请移除 location_types 字段中的所有值。
1870219—账户控制中只允许保存雇主排除项。
1870220—尝试保存的雇主排除项数量超过允许值。

📦 创意 / 图片 / 杂项错误

代码描述
100, subcode 3858258图片未下载——图片 URL 可能无法在线访问或被 robots.txt 屏蔽。需确保图片可通过互联网公开访问。
1885183广告创意帖子由开发模式下的应用创建，应用必须为公开状态。
2490085191x100 裁剪键不再可用，推荐使用 100x100。
2490155广告关联的帖子不可用——可能已被删除或无查看权限。
1885557广告推广的帖子不可用——已删除、未发布或不属于广告的公共主页。
3867105此内容不能用于合作广告。请选择其他内容。
← 返回入门指南 📄 API 参考文档 →