影片 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，則該影片帖子不包含任何隨附文字。

另請參閱