影片 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 工作的公開粉絲專頁上，您需要：

發送 GET 要求至 /{page-id}/videos 端點，以取得粉絲專頁上所有影片的清單。

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

取得用戶影片

準備工作

必備資料：

發送 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，表示影片貼文不含隨附的文字。

另請參閱