動画API

動画の取得

このドキュメントでは、ページ、グループ、ユーザーの動画を取得する方法について説明します。

グループの動画を取得する

開始する前に

ユーザーのグループの動画を取得するには、以下が必要です。

ページのグループの動画を取得するには、以下が必要です。

  • グループを管理するページがリクエストしたページアクセストークン
  • グループ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" } } }

ユーザーの動画を取得する

開始する前に

以下が必要です。

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

制限

  • デフォルトでは、typeを指定しないGETリクエストは、ユーザーがタグ付けされた動画を返します。
  • descriptionが返されない場合は、動画投稿に付属テキストが含まれていません。

参考情報