meta-api-reference

用途：直接调用 Meta Marketing API 时查询端点、对象、字段与请求模式的参考技能，覆盖 campaign、ad set、ad、audience 与创意。配置：API 版本 v22.0，Base URL 为 https://graph.facebook.com/v22.0/；.env 中需 ADS_MANAGER_ACCESS_TOKEN（营销 API）与 AD_LIBRARY_ACCESS_TOKEN（广告库），令牌约 60 天未刷新过期。层级：Ad Account(act_XXXX) → Campaign → Ad Set → Ad → Ad Creative。主要能力与要点：Campaign 端点 POST /{account_id}/campaigns，必填 name、objective、status、special_ad_categories；目标采用 ODAX 枚举（OUTCOME_AWARENESS 等）；支持 CBO/ABO 预算区分，CBO 在 campaign 设 daily_budget/lifetime_budget 并令 is_adset_budget_sharing_enabled 为 "true"，ABO 则在 ad set 设预算。Ad Set 端点 POST /{account_id}/adsets，必填 optimization_goal、billing_event、targeting 等；optimization_goal 与 billing_event、destination_type 均有枚举列表，转换优化需 promoted_object。定向支持 geo_locations、年龄、性别、flexible_spec、custom_audiences 及 Advantage+ 受众（v23.0+ 默认开启）。创意端点 POST /{account_id}/adcreatives，含 object_story_spec 两种模式与 asset_feed_spec；url_tags 仅创建时可设。Ad 端点 POST /{account_id}/ads，status 应设 PAUSED。自定义受众端点 POST /{account_id}/customaudiences，支持邮箱等哈希上传。兴趣可用 GET /search?type=adinterest 查询。限制：资料未提供价格、效果数据与完整分页细节；2026 说明部分细分兴趣自 2025-06 起整合，旧兴趣广告可能停止投放；地理定向不得重叠。