Composants
URL d’hébergement
https://graph-video.facebook.com: adresse utilisée exclusivement pour la publication de vidéos sur des Pages et des Groupes.https://graph.facebook.com: adresse utilisée dans tous les autres cas (création de sondages, obtention d’insights, etc.).
Protocoles d’importation
L’API est compatible avec les protocoles Importation avec reprise et Importation sans reprise. Le protocole d’importation avec reprise permet d'importer des segments vidéo de manière séquentielle tandis que celui sans reprise permet d'importer des vidéos entières. Nous vous recommandons d’utiliser le protocole d’importation avec reprise dans la mesure où il prend en charge des fichiers vidéo plus volumineux et permet une gestion plus efficace des interruptions de connexion.
Ressources
L’API utilise les nœuds ci-dessous.
Vidéos
Le nœud Vidéo constitue la ressource principale de l’API. Lorsque vous importez une vidéo existante, l’API génère une entité Vidéo et la publie soit sur une Page soit dans un Groupe en fonction du nœud que vous ciblez lorsque vous commencez le processus de publication. Les vidéos doivent être publiées sur un nœud cible.
Pages
Les vidéos peuvent être publiées sur un Groupe à condition que l’app dispose des autorisations et fonctionnalités appropriées. De plus, l’utilisateur de l’app doit être autorisé à exécuter des tâches équivalentes à des tâches d’admin sur la Page, ou avoir reçu le rôle d’admin sur la Page via Business Manager.
Groupes
Vous pouvez publier des vidéos sur un Groupe tant que l’app dispose des autorisations et fonctionnalités appropriées et que l’utilisateur de l’app est un admin du Groupe.
Vidéos crosspostées
Les vidéos ayant déjà été publiées peuvent également être publiées sur d’autres Pages gérées par l’utilisateur de l’app sans avoir à les réimporter. Les statistiques sur les vidéos crosspostées peuvent être renvoyées de manière globale (par exemple, le nombre total de vues sur toutes les Pages) ou ventilée par Page.
Diaporamas
L’API vous permet de générer un diaporama vidéo à partir d’un ensemble d’images hébergées sur un serveur public.
Sondages
Vous pouvez utiliser l’API pour créer des sondages sur des vidéos publiées et obtenir les réponses correspondantes.
Publicités
Vous pouvez vous servir des vidéos publiées à l’aide du point de terminaison Contenu publicitaire de l’API Marketing pour créer des publicités vidéo.
Insights
Vous pouvez recueillir des statistiques sur n’importe quelle vidéo publiée. Les statistiques sur les vidéos crosspostées peuvent être renvoyées sous forme de valeurs agrégées ou ventilées par Page.
Webhooks
Pour les vidéos publiées sur des Pages, vous pouvez recevoir des notifications en temps réel concernant les modifications apportées au statut de publication d’une vidéo ou les interactions avec les lecteurs en définissant des Webhooks de Page. Configurez un rappel, puis abonnez-vous aux champs feed et videos de la rubrique Page pour recevoir des notifications. Notez que les notifications ne sont pas envoyées pour les vidéos qui sont importées en tant que secret ou no_story.
Gestion des droits
Pour les vidéos publiées sur une Page, vous pouvez utiliser l’API Rights Management pour créer et appliquer des règles liées aux droits d’auteur afin d’identifier d’autres publications vidéo susceptibles d’enfreindre ces règles, et de les signaler.
Conditions requises
Autorisations
Pour publier sur une Page, l’utilisateur de l’app doit attribuer les autorisations pages_show_list, pages_read_engagement et pages_manage_posts à votre application.
Pour publier sur un Groupe, l’utilisateur de l’app doit attribuer l’autorisation publish_to_groups à votre application.
Fonctionnalités
Aucune fonctionnalité n’est nécessaire pour pouvoir publier sur une Page. Si vous souhaitez publier sur un Groupe, votre app doit bénéficier de la fonctionnalité API Groups.
Rôle d’admin
L’utilisateur de l’app doit être autorisé à exécuter des tâches ADMIN équivalentes sur la Page cible, ou être l’admin du Groupe cible.
Contrôle app
Toutes les autorisations et fonctionnalités nécessitent un Contrôle app.
Fonctionnement
Le flux général de publication d’une vidéo sur une Page ou dans un Groupe est organisé comme suit :
- Obtenir un token d’accès et les autorisations appropriées depuis l’utilisateur de l’app.
- Obtenir la liste des Pages ou des Groupes sur lesquels l’utilisateur de l’app est autorisé à exécuter des tâches équivalentes à des tâches d’admin.
- Permettre à l’utilisateur de l’app de sélectionner la Page ou le Groupe où il souhaite afficher la vidéo.
- Fournir à l’utilisateur de l’app un moyen de sélectionner une vidéo à publier.
- Fractionner la vidéo en plusieurs segments.
- Lancer une session d’importation et importer les segments individuels.
- Terminer la session d'importation.