동영상 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"
    }
  }
}

사용자 동영상 가져오기

시작하기 전에

다음과 같은 항목이 필요합니다.

  • 동영상을 소유한 사용자가 요청한 사용자 액세스 토큰
  • user_videos 권한

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이 반환되지 않으면 동영상 게시물에 포함된 텍스트가 없는 것입니다.

기타 참고 자료