動画API

Facebook動画APIを使ってFacebook動画を取得する

このドキュメントでは、Facebookページやユーザーフィードで公開されている動画のID、説明、更新時刻などの動画データを取得する方法について説明します。

ページの動画を取得する

開始する前に

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

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

開始する前に

以下が必要です。

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が返されない場合は、動画投稿に付属テキストが含まれていません。

参考情報