videos`

使用此端点可将多个视频发布到一个活动中。如要删除或更新一个现有视频，请改用 /{video-id} 节点。

创建

如要将视频发布到活动中，请在 graph-video.facebook.com 上向 /{event-id}/videos 连线发送 POST 请求。

POST /v21.0/{event-id}/videos HTTP/1.1
Host: graph-video.facebook.com

source=%7Bvideo-data%7D

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{event-id}/videos',
    array (
      'source' => '{video-data}',
    ),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{event-id}/videos",
    "POST",
    {
        "source": "{video-data}"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("source", "{video-data}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{event-id}/videos",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"source": @"{video-data}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{event-id}/videos"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

限制

视频必须编码为 multipart/form-data。
如果您通过一个包含多部分数据的 HTTP 请求或通过提供一个视频网址来上传一个视频，该视频大小不得超过 1 GB，且时长不得超过 20 分钟。
上传可续传视频时，视频大小最大为 1.75 GB，时长最多为 45 分钟。

支持的格式

3g2、3gp、3gpp、asf、avi、dat、divx、dv、f4v、flv、m2ts、m4v、mkv、mod、mov、mp4、mpe、mpeg、mpeg4、mpg、mts、nsv、ogm、ogv、qt、tod、ts、vob、wmv。

权限

自 2018 年 4 月 24 日起，我们已移除 pubish_actions 权限。如需了解更多详情，请参阅重大更改更新日志。为便于您的应用用户与 Facebook 分享内容，建议您改用我们的分享产品。

使用此端点需要拥有 publish_actions 权限的用户访问口令。

字段

名称	描述	类型
`id`	视频发布位置的目标编号。	`numeric string`
`title`	视频的标题。	`string`
`description`	有关视频的描述，在任何动态快拍中用作附带的状态消息。此参数可使用以下语法来包含对其他 Facebook 公共主页的提及： @[page-id] 例如，以下描述会以内联方式提及 Facebook 开发者公共主页： Test message @[19292868552] tag 此功能的使用需要审核。但是，如果您是多个公共主页的管理员，且您是某个应用的开发者，则您可以通过使用这些公共主页（来调用 API 和用于提及中）以及该应用，在审核之前自行测试此功能的使用情况。	`string`
`source`	已编码为表单数据的视频。此为必要字段。	`multipart/form-data`
`file_url`	视频文件的可访问网址。不能与 `upload_phase` 一同使用。	`string`
`thumb`	要上传的与某个视频关联的视频缩略图原始数据。	`image`
`upload_phase`	分块上传请求的类型。	`enum{start, transfer, finish}`
`file_size`	整个视频文件的大小，以字节为单位。	`unsigned int32`
`start_offset`	文件块的起始字节位置。	`unsigned int32`
`video_file_chunk`	已编码为表单数据的视频文件块。在 `transfer` 上传阶段，此为必要字段。	`multipart/form-data`
`upload_session_id`	分块上传会话的编号。	`numeric string`

响应

如果成功，则返回：

Struct {
  id: numeric string,
  upload_session_id: numeric string,
  video_id: numeric string,
  start_offset: numeric string,
  end_offset: numeric string,
  success: bool,
  skip_upload: bool,
}

读取

您无法使用此连线读取已上传到活动中的视频。

更新

您无法使用此连线更新评论。

删除

您无法使用此连线进行删除。

活动视频 /{event-id}/videos

创建

限制

支持的格式

权限

字段

响应

读取

更新

删除

活动视频 `/{event-id}/videos`