Meta Marketing API问题：上传视频仅可通过ID查询，无法在媒体库及列表API显示

可能原因及对应解决方案 #

1. 视频未完成转码或审核 #

上传请求返回200仅代表文件已被服务器接收，Meta后台还需要完成转码和内容审核流程，这个过程耗时从几分钟到几十分钟不等。

• 处理方式：等待一段时间后重新调用列表接口或刷新Ads Manager；可通过GET /{media-id}接口查看视频的status字段，当状态显示为READY时，才会出现在媒体库列表中。

2. 请求未包含全状态视频过滤 #

默认情况下，/advideos端点可能只返回状态为READY的视频，若视频处于PROCESSING或ERROR状态，会被自动过滤。

• 处理方式：在请求中添加filtering参数，明确包含所有状态的视频，示例请求如下：

  GET https://graph.facebook.com/v22.0/act_{{ACCOUNT_ID}}/advideos
    ?access_token={{accessToken}}
    &fields=id,title,source,picture,length,format{filter,width,height,picture}
    &filtering=[{"field":"status","operator":"IN","value":["READY","PROCESSING","ERROR"]}]
  

3. 视频归属对象不匹配 #

上传视频时若指定了错误的归属资产（如其他广告账户、公共主页），会导致视频不在当前查询的广告账户媒体库中。

• 处理方式：检查上传请求的参数，确认owner_id或上传目标为当前广告账户；通过GET /{media-id}接口查看owner字段，验证归属是否与act_{{ACCOUNT_ID}}一致。

4. 权限或端点选择问题 #

当前access_token可能缺少必要权限，或使用了不合适的查询端点。

• 处理方式：
  • 确认access_token已拥有ads_management、business_management权限；
  • 尝试使用GET /act_{{ACCOUNT_ID}}/media端点查询，该端点返回广告账户下所有类型的媒体文件（含视频）。

5. 视频转码失败 #

若视频格式不兼容、文件损坏，会导致转码失败进入ERROR状态，默认不会出现在列表中。

• 处理方式：调用GET /{media-id}查看error_code和error_message字段，排查失败原因；重新上传符合要求的视频（支持MP4、MOV格式，编码为H.264，分辨率建议1080p以内）。

内容的提问来源于stack exchange，提问作者YESEUL LEE