登录开始免费试用
easyCoexistence 官方 API

通过 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 天定时发布。

389

Meta 无法从 file_url 中给出的 URL 获取视频文件时的错误代码。

382

视频文件过小、无法上传时的错误代码;Meta 会要求使用更大的文件。

10 min to 6 months

videos 端点上 scheduled_publish_time 的时间范围,从视频发布时开始计算。

0 to 100

processing_progress 的取值范围,表示视频已完成处理的比例,与 video_status 一同返回。

graph.facebook.com

视频上传的主机,依据 Meta 的 Video API 概述,该概述将 graph-video.facebook.com 标记为已弃用。

h

上传返回的文件句柄,作为 fbuploader_video_file_chunk 传给 /{page-id}/videos 以发布视频。

如何将视频发布到粉丝专页?

使用 POST /{page-id}/videos 和粉丝专页访问令牌。文件通过两种方式到达 Meta:file_url,即 Meta 自行获取的视频可访问 URL;或上传,即应用先发送字节内容。file_url 不能与分块上传的参数 upload_phase 同时使用,因此一个请求只能采用其中一种方式。

file_urlUploaded file
Where the video isAt a URL Meta can reachOn your own system
On /{page-id}/videosfile_urlfbuploader_video_file_chunk with the upload's handle
Before publishingNothing: Meta fetches the fileAn upload session, then the bytes
If it failsError 389 when Meta cannot fetch itResume 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 中。
使用 EasyCoexistence 完成这些操作

您的平台也可以在 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 监控

验证时间