API Video

Получение списка видео

В этом документе объясняется, как получить список видеоСтраницы, группы или пользователя.

Получение списка видео группы

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

Чтобы получить список видео группы, вам потребуются:

Чтобы получить список видео для группы Страницы, вам потребуются:

  • маркер доступа к Странице, запрошенный Страницей, которая администрирует группу;
  • функция API Groups.

Отправьте запрос 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 на этой Странице;
  • разрешение pages_read_engagement.

Для общедоступной Страницы, на которой вы не можете выполнять задачу 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" } } }

Получение списка видео пользователя

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

Вам понадобятся:

  • маркер доступа пользователя, запрошенный пользователем, которому принадлежит видео;
  • разрешение 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": "..." } } }

Ограничения

  • По умолчанию запрос GET, для которого не указан параметр type, вернет видео, на которых отмечен данный пользователь.
  • Если API не возвращает description, это означает, что видеопубликация не содержит сопроводительного текста.

См. также