API Video

API Rights Manager

API Rights Manager позволяет издателям заявлять права собственности на видео и управлять правилами для защиты авторских прав с помощью двух новых эндпойнтов: video_copyright_rule и video_copyright.

Разрешения

Для работы с этим API необходимо запросить доступ к инструменту Rights Manager (для его использования нужно войти в Facebook). Подробные сведения о Rights Manager см. на сайте rightsmanager.fb.com.

Заявление прав на видео

API Rights Manager позволяет работать только с теми видео, которые опубликованы на страницах. Чтобы можно было использовать API, каждая такая страница должна быть зарегистрирована.
Перед тем как заявить права на видео, создайте видеоконтент на Странице Facebook. Это можно сделать с помощью API Video Upload или API Live Video.

Инструкции для видео:

  1. Загрузите видео на Facebook и получите его ID.
  2. Воспользуйтесь API Rights Manager, чтобы заявить права.

Инструкции для прямых эфиров:

  1. Создайте объект live_video и получите ID прямой трансляции.
  2. Воспользуйтесь API Rights Manager, чтобы заявить права.
  3. Запустите трансляцию с помощью своего ПО для стриминга.

Инструкции для контрольных файлов

Если видео будет использоваться только в качестве контрольного и вы не хотите распространять его на Facebook, загружайте его с параметром reference_only и вызывайте API Rights Manager с использованием параметра is_reference_video. Если видео предназначено для потоковой передачи, перед началом показа вызовите API Rights Manager с указанием параметра is_reference_video. Видео, в том числе для прямого эфира, не будут отображаться в вашей библиотеке видео. Увидеть их сможет только администратор в разделе контрольных файлов в Rights Manager.

Эндпойнты video_copyright_rule и video_copyright

  • Эндпойнт video_copyright_rule позволяет создавать правила для защиты авторских прав. Например, вы можете указать условие, при выполнении которого регистрируется нарушение прав, и действие, которое нужно предпринять в этом случае.

  • Эндпойнт video_copyright будет полезен, если нужно заявить права на определенное видео. Он также позволяет указать владельца авторских прав и использовать правило для их защиты.

Эндпойнт video_copyright_rule

Эндпойнт video_copyright_rule позволяет создавать правила для защиты авторских прав. В этих правилах определяются действия, которые нужно предпринять, если видео соответствует заданным условиям. Например, вы можете создать правило, в соответствии с которым показ вашего видео должен длиться меньше 3 минут.

Предусмотрено несколько типов условий.

  • GEO: доступность видео в конкретном регионе. Предположим, вы сделали видео доступным в Великобритании и США. Если его посмотрел человек из Великобритании, значит, условие соблюдено.
  • OVERLAP_DURATION: длительность совпадающего фрагмента. Например, правило может срабатывать, когда обнаруживаются совпадения дольше или короче 2 или 3 минут.
  • MATCH_OVERLAP_PERCENTAGE: доля совпадения с вашим видео, например больше или меньше 20 %.
  • REFERENCE_OVERLAP_PERCENTAGE: доля совпадения с вашим контрольным файлом, например больше или меньше 50 %.
  • MONITORING_TYPE: совпадает ли только изображение, только звук или и то, и другое.
  • PUBLISHER_TYPE: владеет ли совпадающим видео Страница, профиль или любой из этих субъектов.
  • PRIVACY: определяет, доступно ли совпадающее видео всем людям, только ограниченной аудитории либо хотя бы кому-то. Не доступные всем видео имеют ограниченную аудиторию. Например, видео, которые кто-либо опубликовал для своих друзей или членов закрытой группы.

Предусмотрено четыре типа действий.

  • TRACK: позволяет отслеживать совпадающие видео, не принимая никаких мер. В будущем вы сможете также просматривать статистику по совпадающим видео.
  • MONETIZE: позволяет претендовать на часть выручки от рекламы, получаемой от видео. Для этого вы должны настроить платежи в разделе Rights Manager настроек своей Страницы.
  • BLOCK: если заблокировать видео, оно не будет доступно в регионах, где вы заявили свои авторские права на него.
  • MANUAL_REVIEW: позволяет проводить проверку вручную. Совпадающее видео появится в разделе «Ручная проверка» в Rights Manager, и вы сможете решить, что делать дальше. Обнаруженные видео присутствуют в этом разделе не дольше 30 дней.

Создание правила для защиты авторских прав

Отправьте запрос POST к границе контекста video_copyright_rules по следующему пути: POST/{pageid}/video_copyright_rules.

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyright_rules' \
 -F 'access_token=XXXXXXXX' \
 -F 'name="testrule"' \
 -F 'condition_groups=[{action:"MANUAL_REVIEW",conditions:[{type:"MONITORING_TYPE",operator:"IS",value:"VIDEO_ONLY"},{type:"OVERLAP_DURATION",operator:"LESS_THAN",value:120000},{type:"GEO",operator:"IN_SET",value:["AR","AU"]}]}]'

Чтение правила для защиты авторских прав

Отправьте запрос GET /video_copyright_rule_id request, чтобы получить информацию о правиле для защиты авторских прав.

Примечание. В этом примере 576407315867188 — это ID правила для защиты авторских прав.

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?&access_token=XXXXXXXX' \

Удаление правила для защиты авторских прав

Чтобы удалить прямой эфир, отправьте запрос DELETE /video_copyright_rule_id.

Эндпойнт video_copyright

Эндпойнт video_copyright позволяет указать, на какие видео вы хотите заявить авторские права. Вы также можете занести в «белый» список определенные страницы или пользователей, разрешив им публиковать ваше контрольное видео. Например, если у вас 3 страницы и вы хотите защитить свои права на определенное видео, но сохранить возможность публиковать его на них, занесите эти страницы в «белый» список.

Создание эндпойнта video_copyright

Отправьте запрос POST к границе контекста video_copyrights следующим образом: /{page_id}/video_copyrights.

Примечание. В этом примере 576425449198708 — это ID видео, авторские права на которое будут охраняться.

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyrights' \
-F  'access_token=XXXXXXXX' \
-F  'copyright_content_id=576425449198708' \
-F  'is_reference_video=true' \
-F  'monitoring_type=VIDEO_ONLY' \
-F  'rule_id=576407315867188' \
-F  'whitelisted_ids=[139577256378818]' \
-F  'ownership_countries=[“us”,”ca”]' \
Return values: Video copyright id.
{"id":"576425925865327"}

Для любого видео вы можете запросить поле copyright, чтобы получить больше информации об узле video_copyright.

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?fields=copyright&access_token=XXXXXXXX' \

Эндпойнт video_copyright позволяет изменять, считывать и удалять информацию. Дополнительные сведения см. в этой документации.