通过 API 向 Facebook 粉丝专页发布视频
视频通过 POST /{page-id}/videos 发布到 Facebook 粉丝专页。文件可以使用 file_url(由 Meta 自行下载的 URL),也可以由应用先上传到 Meta。title 为视频命名,description 是 Meta 可能随帖子一同显示的文字。Meta 随后处理文件,GET /{video-id}?fields=status 返回的 video_status 在处理中时为 processing,直到变为 ready。
easyCoexistence 可通过 Claude、ChatGPT 或您自己的代码,使用 publish_facebook_post 向 Facebook 粉丝专页发布视频,既可立即发布,也可提前至多 90 天定时发布。
Meta 无法从 file_url 中给出的 URL 获取视频文件时的错误代码。
视频文件过小、无法上传时的错误代码;Meta 会要求使用更大的文件。
videos 端点上 scheduled_publish_time 的时间范围,从视频发布时开始计算。
processing_progress 的取值范围,表示视频已完成处理的比例,与 video_status 一同返回。
视频上传的主机,依据 Meta 的 Video API 概述,该概述将 graph-video.facebook.com 标记为已弃用。
上传返回的文件句柄,作为 fbuploader_video_file_chunk 传给 /{page-id}/videos 以发布视频。
如何将视频发布到粉丝专页?
使用 POST /{page-id}/videos 和粉丝专页访问令牌。文件通过两种方式到达 Meta:file_url,即 Meta 自行获取的视频可访问 URL;或上传,即应用先发送字节内容。file_url 不能与分块上传的参数 upload_phase 同时使用,因此一个请求只能采用其中一种方式。
| file_url | Uploaded file | |
|---|---|---|
| Where the video is | At a URL Meta can reach | On your own system |
| On /{page-id}/videos | file_url | fbuploader_video_file_chunk with the upload's handle |
| Before publishing | Nothing: Meta fetches the file | An upload session, then the bytes |
| If it fails | Error 389 when Meta cannot fetch it | Resume from the offset Meta reports |
文件不在线上时,上传如何工作?
Meta 的视频发布指南使用 Resumable Upload API。向 POST /{app-id}/uploads 发送 file_name、file_length 和 file_type 以打开会话;再向 POST /upload:{session-id} 发送 file_offset 标头及字节内容,即可返回句柄 h。随后向 POST /{page-id}/videos 发送 fbuploader_video_file_chunk,其值为该句柄,并附带 title 和 description 以发布视频。这些上传调用使用用户访问令牌。
- 中断的上传会从 GET /upload:{session-id} 返回的
file_offset处继续。 - 视频参考文档还记载了同一端点上的分块上传:
upload_phase依次取值 start、transfer 和 finish,并使用start_offset、file_size和video_file_chunk。
title 和 description 有什么作用?
title 是视频的标题。据 Meta 所述,description 是可能显示在相关动态中的帖子描述文字,因此帖子的文字应放在这里。两者在 videos 端点上都是可选的,而 publish_facebook_post 会把其 message 作为 description 发送,并不设置 title。
如何知道视频已就绪?
Meta 在视频到达后进行处理。GET /{video-id}?fields=status 返回 video_status:Meta 处理期间为 processing;视频上传、编码并生成缩略图后为 ready;处理失败则为 error。processing_progress 给出从 0 到 100 的完成比例。Meta 也可以通过 videos 字段的粉丝专页 Webhook 报告发布状态,但 easyCoexistence 并未订阅该字段。
视频可以有多大、多长?
粉丝专页的 videos 参考文档和 Meta 的视频发布指南都没有说明最大文件大小或时长;它们明确的大小规则是错误 382,即文件过小无法上传。Meta 的 Reels 和 Stories 指南另有时长规定:Reel 为 3 至 90 秒,视频故事最长 60 秒。easyCoexistence 安排定时发布视频时,会在当时复制文件,并拒绝超过 1 GB 的文件。
需要哪些权限和粉丝专页任务?
pages_manage_posts、pages_read_engagement 和 pages_show_list,并且访问令牌须来自能够执行 CREATE_CONTENT 任务的人员,依据 videos 参考文档和发布指南。Meta 的 Video API 概述要求更严格:该人员应能够对粉丝专页执行与管理员同等的任务,或持有通过 Business Manager 授予的管理员角色。
视频发布可能返回哪些错误?
Meta 的 videos 参考文档列出了 POST /{page-id}/videos 的以下错误:
- 389:无法从 URL 获取视频文件。
- 382:视频文件过小;请使用更大的文件重试。
- 6000:上传视频文件时出现问题;请换用其他文件重试。
- 6001:上传视频时出现问题;请重试。
- 368:该操作被视为滥用,或因其他原因不被允许。
- 100:参数无效;200:权限错误;190:OAuth 2.0 访问令牌无效。
publish_facebook_post 如何发布视频?
它接收 video_url(文件的公开 HTTPS 链接)和 message,并将它们以 file_url 和 description 的形式发送到 /{page-id}/videos,因此由 Meta 自行获取视频。一个帖子只能包含一个视频,视频旁边附带的链接会被拒绝,因此请把 URL 放入 message 中。返回结果中的 post_id 保存 Meta 返回的 ID;对于视频,它就是视频自身的 ID。
视频帖子如何定时发布?
为 publish_facebook_post 提供带时区的 ISO 8601 格式 scheduled_at,时间须在 1 分钟至 90 天之后。easyCoexistence 在安排帖子时复制视频,并在该时间发布到粉丝专页;list_scheduled_posts 可列出该帖子,update_scheduled_post 可更改时间或文字,cancel_scheduled_post 可取消发布。Meta 自身的 videos 端点上的 scheduled_publish_time 允许的范围为 10 分钟至 6 个月。
常见错误
- 将 file_url 指向播放视频的页面,而非文件本身。Meta 会自行下载该地址;无法获取时将以错误 389 失败。
- 上传到 graph-video.facebook.com。Meta 的 Video API 概述已将该主机标记为视频上传已弃用,并要求使用 graph.facebook.com。
- 在视频就绪前提前发布公告。请检查状态,直到 video_status 显示 ready,因为发布调用返回后处理仍会继续。
- 随视频发送链接。publish_facebook_post 会拒绝与文件同时出现的链接;请将 URL 写入 message 中。
您的平台也可以在 Partner API 上使用 POST /channels/:id/posts 完成同样的操作。每个连接每月 US$ 9 至 US$ 0.75,随连接数增加而降低,前 3 天免费。
常见问题
我能否通过 API 从电脑上传视频到 Facebook 粉丝专页?
可以,通过 Meta 的 Resumable Upload API 上传,它会返回用于 /{page-id}/videos 的句柄;也可以使用该端点上的分块上传。publish_facebook_post 则需要公开的 HTTPS URL,因此请先托管该文件。
视频能否上传后不出现在粉丝专页的动态中?
可以。将 published 设为 false 可暂存帖子,no_story 会隐藏动态和时间线故事,secret 则使视频不在 Facebook 上显示,也不出现在搜索结果中。
一个视频能否发布到多个粉丝专页?
可以,通过交叉发布:已发布的视频可以发布到该用户管理的其他粉丝专页上,无需重新上传,并且在每个粉丝专页上都会获得各自的视频 ID。
easyCoexistence 对 Facebook 粉丝专页的收费是多少?
每个连接每月 US$ 9 至 US$ 0.75,按您的连接总数确定,前 3 天免费。每个粉丝专页即一个连接。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间