影片 API

獲取影片

本文件講解如何獲取專頁、群組和用戶的影片。

獲取群組影片

準備工作

要獲取用戶群組的影片，您將需要：

要獲取專頁群組的影片，您將需要：

傳送 GET 要求至 /{group-id}/videos 端點：

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

成功的話，應用程式就會收到以下內容：

{ "data": [ { "updated_time": "2020-05-18T18:51:15+0000", "id": "{video-id-1}" }, { "description": "Sunshine", "updated_time": "2020-05-18T18:35:09+0000", "id": "{video-id-2}" } ... ], "paging": { "cursors": { "before": "...", "after": "..." } } }

獲取專頁影片

準備工作

如果您可以在有關專頁上執行 MANAGE 任務，您將需要：

如果有關專頁是公開專頁，而且您無法在專頁上執行 MANAGE 任務，您將需要：

向 /{page-id}/videos 端點傳送 GET 要求，以獲取專頁相關影片的完整列表。

curl -i -X GET "https://graph.facebook.com/{page-id}/videos?access_token={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，則該影片帖子不包含任何隨附文字。

另請參閱