Обзор Video API от Meta

Video API — это набор конечных точек Graph API, которые позволяют приложениям публиковать существующие видео на Страницах, администрируемых пользователями приложения.

Компоненты

URL хоста

Все запросы передаются в URL хоста graph.facebook.com.

Протоколы загрузки

Загружайте видео с помощью Resumable Upload API.

Ресурсы

API использует перечисленные ниже узлы.

Видео

Узел Video — это основной ресурс API. Когда вы загружаете существующее видео, API генерирует объект Video и публикует его на Странице. Видео должны публиковаться на целевом узле.

Страницы

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

Кросспостинг видео

Уже опубликованные видео можно публиковать на других Страницах, которые администрирует пользователь приложения, без их повторной загрузки. Статистику по кросспостингу видео можно получить в виде обобщенных значений (например, суммы всех просмотров на всех Страницах) или с разбиением по Страницам.

Слайд-шоу

С помощью этого API можно генерировать видео в формате слайд-шоу из набора изображений, размещенного на общедоступном сервере.

Опросы

С помощью этого API можно создавать опросы для опубликованных видео и получать их результаты.

Реклама

Опубликованные видео можно использовать в сочетании с конечной точкой рекламного креатива Marketing API для создания видеорекламы.

Статистика

Вы можете получить статистику по любому опубликованному видео. Статистику по кросспостингу видео можно получить в виде обобщенных значений или с разбиением по Страницам.

Webhooks

С помощью Webhooks Страниц вы можете в режиме реального времени получать уведомления об изменениях статуса публикации и взаимодействии зрителей с ними. Для получения уведомлений настройте обратный вызов, в затем подпишитесь на поля feed и videos темы Страницы. Обратите внимание: уведомления о видео, загруженных с параметром secret или no_story, не отправляются.

Управление правами

Для видео, публикуемых на Страницах, можно с помощью Rights Manager API создавать и применять правила защиты авторских прав, позволяющие обнаруживать видео, потенциально нарушающие эти права, и сообщать о них.

Требования

Разрешения

Для публикации на Странице пользователь вашего приложения должен предоставить ему разрешения pages_show_list, pages_read_engagement и pages_manage_posts.

Роль администратора

Пользователь приложения должен иметь возможность выполнять задачи, аналогичные задачам ADMIN, на целевой Странице.

Проверка приложения

Для использования всех разрешений требуется пройти проверку приложения.

Принцип работы

Общая процедура публикации видео на Странице:

1. Получите маркер доступа и соответствующие разрешения от пользователя приложения.
2. Получите список всех Страниц, для которых пользователь приложения может выполнять задачи, аналогичные задачам администратора.
3. Предусмотрите для пользователя приложения возможность выбрать Страницу, где он хочет опубликовать видео.
4. Предусмотрите для пользователя приложения возможность выбрать видео для публикации.
5. Загрузите видео с помощью Resumable Upload API.
6. Опубликуйте видео на Странице, используя ID этого видео.