API Video

Obtention de vidéos

Ce document explique comment obtenir des vidéos sur des Pages, des Groupes et des Utilisateurs.

Obtenir des vidéos d’un Groupe

Avant de commencer

Pour obtenir des vidéos d’un groupe d’un utilisateur, vous aurez besoin des éléments suivants :

  • Un token d’accès utilisateur demandé par une personne qui gère le groupe
  • L’autorisation publish_to_groups

Pour obtenir des vidéos d’un groupe d’une Page, vous aurez besoin des éléments suivants :

  • Un token d’accès de Page demandé par la Page qui gère le groupe
  • La fonctionnalité API Groups

Envoyez une requête GET au point de terminaison /{group-id}/videos :

curl -i -X GET "https://graph.facebook.com/{group-id}/videos?access_token={access-token}"

En cas de réussite, votre application reçoit la réponse suivante :

{ "data": [ { "updated_time": "2020-05-18T18:51:15+0000", "id": "{video-id-1}" }, { "description": "Sunshine", "updated_time": "2020-05-18T18:35:09+0000", "id": "{video-id-2}" } ... ], "paging": { "cursors": { "before": "...", "after": "..." } } }

Obtenir des vidéos d’une Page

Avant de commencer

Pour les Pages sur lesquelles vous êtes autorisé à exécuter la tâche MANAGE, vous aurez besoin des éléments suivants :

Pour les Pages publiques sur lesquelles vous n’êtes pas autorisé à exécuter la tâche MANAGE, vous aurez besoin des éléments suivants :

Envoyez une requête GET au point de terminaison /{page-id}/videos pour obtenir la liste de toutes les vidéos d’une Page.

curl -i -X GET "https://graph.facebook.com/{page-id}/videos?access_token={access-token}"

En cas de réussite, votre app reçoit la réponse suivante :

{ "data": [ { "description": "Clouds", "updated_time": "2019-09-25T17:18:30+0000", "id": "2153206464921154" }, { "updated_time": "2020-03-26T23:45:11+0000", "id": "2232477747039197" }, ... ], "paging": { "cursors": { "before": "MjE1MzIwNjQ2NDkyMTE1NAZDZD", "after": "MTQwOTU5MTg4NTc2MzM0MwZDZD" } } }

Obtenir des vidéos d’un Utilisateur

Avant de commencer

Vous aurez besoin des éléments suivants :

Envoyez une requête GET à /{user-id}/videos?type=uploaded pour obtenir toutes les vidéos ayant été importées par une personne ou /{user-id}/videos?type=tagged pour obtenir toutes les vidéos dans lesquelles une personne est identifiée.

curl -i -X GET "https://graph.facebook.com/{user-id}/videos ?type=uploaded &access_token={user-access-token}"

En cas de réussite, votre app reçoit la réponse suivante :

{ "data": [ { "description": "Rain", "updated_time": "2020-05-18T20:07:47+0000", "id": "{video-id-1}" }, { "updated_time": "2020-05-20T12:26:19+0000", "id": "{video-id-2}" }, ... ] "paging": { "cursors": { "before": "...", "after": "..." } } }

Limites

  • Par défaut, une requête GET sans type spécifié renverra les vidéos dans lesquelles une personne est identifiée.
  • Si aucune description n’est renvoyée, aucun texte n’accompagne la publication vidéo.

Voir aussi