视频 API

使用 Facebook 视频 API 获取 Facebook 视频

本文档介绍如何获取 Facebook 公共主页或用户动态上已发布视频的视频数据，例如编号、描述和更新时间。

获取公共主页上的视频

前期准备

对于您可以在其上执行 MANAGE 任务的公共主页，您将需要：

对于已发布的公共主页（您无法在此类公共主页上执行 MANAGE 任务），您将需要：

向 /<PAGE_ID>/videos 端点发送 GET 请求，以获取某个公共主页上视频的完整清单。

curl -i -X GET "https://graph.facebook.com/&lt;PAGE_ID>/videos?access_token=&lt;PAGE_ACCESS_TOKEN>"

成功后，应用会收到以下响应：

{
  "data": [
    {
      "description": "Clouds",
      "updated_time": "2019-09-25T17:18:30+0000",
      "id": "2153206464921154"
    },
    {
      "updated_time": "2020-03-26T23:45:11+0000",
      "id": "2232477747039197"
    },
    ...
  ],
  "paging": {
    "cursors": {
      "before": "MjE1MzIwNjQ2NDkyMTE1NAZDZD",
      "after": "MTQwOTU5MTg4NTc2MzM0MwZDZD"
    }
  }
}

获取用户视频

前期准备

您需要提供：

向 /{user-id}/videos?type=uploaded 发送 GET 请求，以获取某用户已上传的所有视频，或向 /{user-id}/videos?type=tagged 发送该请求，以获取其中标记了某用户的所有视频。

curl -i -X GET "https://graph.facebook.com/{user-id}/videos
  ?type=uploaded
  &access_token={user-access-token}"

成功后，应用会收到以下响应：

{
  "data": [
    {
      "description": "Rain",
      "updated_time": "2020-05-18T20:07:47+0000",
      "id": "{video-id-1}"
    },
    {
      "updated_time": "2020-05-20T12:26:19+0000",
      "id": "{video-id-2}"
    },
    ...
  ]
  "paging": {
    "cursors": {
      "before": "...",
      "after": "..."
    }
  }
}

限制

  • 默认情况下，未指定 type 的 GET 请求将返回标记了某用户的视频。
  • 如果未返回任何 description，则该视频帖不包含任何随附文字。

另请参阅