API Video

Получение видео Facebook с помощью Facebook Video API

В этом документе рассказывается, как получать информацию (в том числе ID, описание и время обновления) о видео, опубликованных на Страницах Facebook и в лентах пользователей.

Получение видео Страниц

Прежде чем начать

Для Страниц, на которых вы можете выполнять задачу MANAGE, вам понадобятся:

  • маркер доступа к Странице, запрошенный пользователем, который может выполнять задачу MANAGE на этой Странице;
  • разрешение pages_read_engagement.

Для опубликованных Страниц, на которых вы не можете выполнять задачу MANAGE, вам понадобятся:

Чтобы получить список всех видео Страницы, отправьте запрос GET к конечной точке /<PAGE_ID>/videos.

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 по умолчанию вернет видео, на которых отмечен этот пользователь.
  • Если API не возвращает description, это означает, что видеопубликация не содержит сопроводительного текста.

См. также