影片 API

使用 Facebook 影片 API 取得 Facebook 影片

本文件說明如何取得在 Facebook 粉絲專頁或用戶動態消息上發佈之影片的影片資料，例如編號、描述和更新時間。

取得粉絲專頁影片

準備工作

在您能執行 MANAGE 工作的粉絲專頁上，您需要：

在您無法執行 MANAGE 工作的已發佈粉絲專頁上，您需要：

發送 GET 要求至 /<PAGE_ID>/videos 端點，以取得粉絲專頁上所有影片的清單。

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"
    }
  }
}

取得用戶影片

準備工作

必備資料：

發送 GET 要求至 /{user-id}/videos?type=uploaded，以取得用戶已上傳的所有影片，或發送 /{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": "..."
    }
  }
}

限制

  • 根據預設，發送 GET 要求且不指定 type 將傳回標記了某人的影片。
  • 如果未傳回 description，表示影片貼文不含隨附的文字。

另請參閱