API Video

API Rights Manager

L’API Rights Manager permet aux éditeurs de revendiquer la propriété des droits d’auteur de vidéos et de gérer les règles de correspondance des droits d’auteur avec deux nouveaux points de terminaison : les points de terminaison video_copyright_rule et video_copyright.

Autorisations

Pour utiliser cette API, vous devez demander un accès à l’outil Rights Manager (vous devez être inscrit à Facebook pour pouvoir utiliser cet outil). Vous pouvez en savoir plus sur l’outil Rights Manager à l’adresse rightsmanager.fb.com.

Protéger une vidéo par des droits d’auteur

L’API Rights Manager peut uniquement être appliquée aux vidéos sur des Pages. Toutes les Pages doivent passer par le processus d’inscription afin d’être autorisées à utiliser l’API.
Avant de pouvoir protéger une vidéo par des droits d’auteur, vous devez créer du contenu vidéo sur une Page Facebook. Pour ce faire, vous pouvez utiliser l’API Video Upload ou l’API Live Video.

Voici les étapes pour les vidéos :

  1. Importez une vidéo sur Facebook et obtenez l’ID de la vidéo.
  2. Utilisez l’API Rights Manager pour protéger la vidéo par des droits d’auteur.

Voici les étapes pour les vidéos en direct :

  1. Créez un objet live_video et obtenez l’ID de la vidéo en direct.
  2. Utilisez l’API Rights Manager pour protéger la vidéo en direct par des droits d’auteur.
  3. Commencez à diffuser en direct à l’aide de votre logiciel de streaming.

Référence uniquement

Si la vidéo doit être uniquement utilisée comme vidéo de référence et non pour être consommée et diffusée sur Facebook, elle doit être importée à l’aide du paramètre 'reference_only' et l’API Rights Manager doit être appelée en utilisant le paramètre is_reference_video. Pendant la diffusion en continu, veillez simplement à appeler Rights Manager avec le paramètre 'is_reference_video' avant de commencer la diffusion. La vidéo ou la vidéo en direct n’apparaîtra pas dans votre vidéothèque et ne sera visible que par l’administrateur, dans la section Fichiers de référence de l’outil Rights Manager.

Comprendre les points de terminaison video_copyright_rule et video_copyright

  • Point de terminaison video_copyright_rule : ce point de terminaison vous permet de créer une règle de droit d’auteur. Par exemple, vous pouvez déterminer dans quel type de condition un signalement de droit d’auteur doit être déclenché et quel type d’action doit être pris.

  • Point de terminaison video_copyright : vous pouvez utiliser ce point de terminaison pour protéger une vidéo spécifique par des droits d’auteur. Vous pouvez également indiquer la propriété des droits d’auteur et appliquer une règle de droit d’auteur dans ce cas.

Le point de terminaison video_copyright_rule

Le point de terminaison video_copyright_rule vous permet de créer des règles de droit d’auteur qui déterminent les actions à prendre sur une vidéo correspondant à ces règles. Par exemple, en tant que titulaire des droits, vous pouvez créer une règle de droit d’auteur qui permet d’utiliser votre vidéo pendant moins de trois minutes.

Il existe plusieurs types de conditions :

  • GEO : détermine si la vidéo est disponible dans un lieu spécifique. Par exemple, si une vidéo peut être vue au Royaume-Uni et que la condition géographique est 'UK and US', alors la vidéo remplit la condition.
  • OVERLAP_DURATION : détermine la durée de la correspondance (par ex., supérieure ou inférieure à deux ou trois minutes)
  • MATCH_OVERLAP_PERCENTAGE : détermine le pourcentage de correspondances de la vidéo correspondante (par ex., supérieur ou inférieur à 20 % de la vidéo correspondante)
  • REFERENCE_OVERLAP_PERCENTAGE : détermine le pourcentage de correspondances de votre fichier de référence (par ex., supérieur ou inférieur à 50 %)
  • MONITORING_TYPE : détermine s’il y a des correspondances vidéo, audio ou les deux
  • PUBLISHER_TYPE : détermine si la vidéo associée appartient à une Page ou à un profil.
  • PRIVACY : détermine si la vidéo correspondante était publique ou privée. Les vidéos privées ont une audience limitée. Par exemple, une vidéo visible par les amis d’une personne ou par un groupe est privée.

Il existe quatre types d’action disponibles :

  • TRACK : cette action vous permet d’effectuer un suivi de la vidéo correspondante, sans réaliser aucune action sur celle-ci. À l’avenir, vous pourrez également voir des insights sur la vidéo correspondante.
  • MONETIZE : cette action vous permet de partager le revenu publicitaire généré par une vidéo. Cela exige d’avoir configuré les Paiements, ce que vous pouvez faire depuis la section Rights Manager des paramètres de votre Page.
  • BLOCK : bloquer une vidéo signifie qu’elle ne sera visible dans aucun emplacement géographique dans lequel vous en êtes le propriétaire.
  • MANUAL_REVIEW : cette action enverra la correspondance à la section Examen manuel du Rights Manager, de sorte que vous puissiez appliquer manuellement une action sur la vidéo correspondante. Les correspondances de votre section Examen manuel expireront dans 30 jours.

Créer une règle de droit d’auteur

Vous pouvez créer une règle de droit d’auteur en faisant une demande POST à l’arête video_copyright_rules en suivant le chemin ci-dessous : 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"]}]}]'

Lire une règle de droit d’auteur

Envoyez une GET /video_copyright_rule_id request pour obtenir plus d’informations sur la règle de droit d’auteur.

** Notez que dans cet exemple, 576407315867188 est l’ID de la règle de droit d’auteur.

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

Supprimer une règle de droit d’auteur

Vous pouvez supprimer une vidéo en direct en faisant une demande DELETE /video_copyright_rule_id.

Le point de terminaison video_copyright

Le point de terminaison video_copyright vous permet d’indiquer quelle vidéo vous souhaitez protéger par des droits d’auteur. Depuis ce point de terminaison, vous pouvez mettre d’autres Pages ou utilisateurs sur liste blanche afin qu’ils puissent utiliser la vidéo de référence. Par exemple, si vous avez trois Pages et que vous souhaitez protéger une vidéo spécifique par des droits d’auteur pour qu’elle puisse être lue sur toutes vos Pages, vous pouvez ajouter ces Pages à la liste blanche.

Créer un point de terminaison video_copyright

Vous pouvez faire une demande POST à l’arête video_copyrights en suivant les chemins ci-dessous : /{page_id}/video_copyrights

** Notez que dans cet exemple, 576425449198708 est l’ID de la vidéo représentant la vidéo à protéger par des droits d’auteur.

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"}

Pour n’importe quelle vidéo donnée, vous pouvez interroger le champ 'copyright' pour obtenir plus d’informations sur le nœud video_copyright.

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

Les fonctionnalités de mise à jour, de lecture et de suppression sont également disponibles pour le point de terminaison video_copyright. Pour en savoir plus, veuillez consulter la documentation sur les points de terminaison protégeant les vidéos par des droits d’auteur.