API Video

Obtenir des vidéos Facebook à l’aide de l’API Facebook Video

Ce document vous montre comment obtenir des données de l’API Video (ID, description, et date et heure de mise à jour, par exemple) relatives à des vidéos publiées sur des Pages Facebook ou des Fils d’utilisateur·ices.

Obtenir des vidéos de Page

Avant de commencer

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

Pour les Pages publiées sur lesquelles vous n’êtes pas autorisé·e à effectuer 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/&lt;PAGE_ID>/videos?access_token=&lt;PAGE_ACCESS_TOKEN>"

En cas de réussite, votre application 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’utilisateur·ice

Avant de commencer

Vous aurez besoin des éléments suivants :

  • Un token d’accès utilisateur·ice demandé par l’utilisateur·ice propriétaire de la vidéo
  • L’autorisation user_videos

Envoyez une requête GET à /{user-id}/videos?type=uploaded pour obtenir toutes les vidéos 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 application 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, cela signifie qu’aucun texte n’accompagne la publication vidéo.

Voir aussi