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.).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.
L’API utilise les nœuds ci-dessous.
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.
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.
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.
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.
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.
Vous pouvez utiliser l’API pour créer des sondages sur des vidéos publiées et obtenir les réponses correspondantes.
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.
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.
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
.
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.
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.
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.
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.
Toutes les autorisations et fonctionnalités nécessitent un Contrôle app.
Le flux général de publication d’une vidéo sur une Page ou dans un Groupe est organisé comme suit :