Обзор

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

Компоненты

URL хоста

• https://graph-video.facebook.com — используется исключительно для публикации видео на Страницах и в группах.
• https://graph.facebook.com — используется для всего остального (создания опросов, получения статистики и т. д.).

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

API поддерживает протоколы возобновляемой и невозобновляемой загрузки. Протокол возобновляемой загрузки используется для последовательной загрузки фрагментов видео, в то время как протокол невозобновляемой загрузки — для загрузки видео целиком. Мы рекомендуем использовать протокол возобновляемой загрузки, так как он поддерживает работу с видеофайлами большего размера и позволяет эффективнее обрабатывать ситуации с обрывом подключения.

Ресурсы

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

Видео

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

Страницы

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

Группы

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

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

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

Слайд-шоу

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

Опросы

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

Реклама

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

Статистика

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

Webhooks

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

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

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

Требования

Разрешения

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

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

Функции

Для публикации на Странице никакие функции не требуются. Для публикации в группе для приложения должна быть одобрена функция API Groups.

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

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

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

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

Как это работает

Ниже описана общая процедура публикации видео на Странице или в группе.

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