概览

视频 API 由一系列图谱 API 端点组成,借助该 API,应用可以在应用用户管理的主页小组上发布现有视频。

组件

托管网址

  • https://graph-video.facebook.com — 专用于在主页和小组上发布视频。
  • https://graph.facebook.com — 用于任何其他操作(创建投票活动、获取成效分析等)。

上传协议

该 API 支持可续传不可续传上传协议。可续传上传协议用于按顺序上传视频区块,而不可续传上传协议用于上传完整视频。我们建议使用可续传上传协议,因为它支持更大的视频文件,并可以让您更有效地应对连接中断问题。

资源

该 API 使用以下节点。

视频

视频节点是 API 的主要资源。当您上传已有视频时,API 会生成一个视频实体并将其发布到主页小组上,具体取决于您在开始发布流程时定为目标的节点。视频必须发布到目标节点上。

主页

只要应用拥有相应的权限功能,视频就可以发布到小组上。此外,应用用户必须能够在主页上执行管理员级别的任务,或通过商务管理平台被授予主页的管理员角色

小组

只要应用拥有相应的权限功能,并且应用用户是小组的管理员,视频就可以发布到小组上。

交叉发布视频

应用用户也可以将已发布的视频发布到其管理的其他主页上,而无需重新上传视频。交叉发布视频的成效分析可以作为总值(例如所有主页的观看量的总和)返回,也可以按主页细分。

幻灯片

您可以使用该 API 基于托管在公共服务器上的一系列图像生成幻灯片视频

投票活动

您可以使用该 API 为已发布的视频创建投票活动,并获取投票活动的结果。

广告

可以将已发布的视频与市场营销 API 的广告创意端点相结合,以建立视频广告。

成效分析

您可以获取任何已发布视频的成效分析交叉发布视频的成效分析可以作为总值返回,也可以按主页细分。

Webhooks

对于发布在主页上的视频,您可以通过设置主页 Webhooks,获取关于视频发布状态更改和观众互动情况的实时通知。设置回调,然后订阅主页主题的 feedvideos 字段即可获取通知。请注意,系统无法为作为 secretno_story 上传的视频发送通知。

权限管理

对于发布在主页上的视频,您可以使用权限管理 API 来创建和应用版权规则,以发现并报告其他已发布视频中可能违规的视频。

要求

权限

要在主页上发布视频,应用用户必须向您的应用授予 pages_show_listpages_read_engagementpages_manage_posts 权限。

要在小组上发布视频,应用用户必须向您的应用授予 publish_to_groups 权限。

功能

在主页上发布视频无需任何功能。要在小组上发布视频,您的应用必须具有使用小组 API 功能的权限。

管理员角色

应用用户必须可以在目标主页上执行 ADMIN 级别的任务,或者是目标小组的管理员。

应用审核

所有权限和功能都需要接受应用审核

运作方式

在主页或小组上发布视频的一般流程如下所示:

  1. 从应用用户处获取访问口令和相应的权限。
  2. 获取应用用户可以对其执行管理员级别任务的主页或小组的清单。
  3. 为应用用户提供一种方式来选择希望将视频显示在哪一个主页或小组上。
  4. 为应用用户提供一种方式来选择要发布的视频。
  5. 将视频拆分成较小的区块。
  6. 发起上传会话,并上传各个区块。
  7. 结束上传会话。