Video API

Facebook-Videos mit der Facebook Video API abrufen

In diesem Dokument erfährst du, wie du Videodaten wie IDs, Beschreibungen und Aktualisierungszeiten für auf Facebook-Seiten oder in Nutzer*innen-Feeds veröffentlichte Videos abrufst.

Seiten-Videos abrufen

Bevor du beginnst

Für Seiten, für die du die MANAGE-Aufgabe ausführen kannst, benötigst du Folgendes:

  • Ein Seiten-Zugriffstoken, das von einer Person angefordert wurde, die die MANAGE-Aufgabe für die Seite ausführen kann
  • Die Berechtigung pages_read_engagement

Für veröffentlichte Seiten, für die du die MANAGE-Aufgabe nicht ausführen kannst, benötigst du Folgendes:

Sende eine GET-Anfrage an den /<PAGE_ID>/videos-Endpunkt, um eine Liste aller Videos einer Seite abzurufen.

curl -i -X GET "https://graph.facebook.com/&lt;PAGE_ID>/videos?access_token=&lt;PAGE_ACCESS_TOKEN>"

Wenn der Vorgang erfolgreich verläuft, erhält deine App diese Antwort:

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

Nutzer*innen-Videos abrufen

Bevor du beginnst

Voraussetzungen:

  • Ein Nutzer*innen-Zugriffstoken, das von dem*der Nutzer*in angefordert wurde, dem*der das Video gehört
  • Die Berechtigung user_videos

Sende eine GET-Anfrage an /{user-id}/videos?type=uploaded, um alle Videos abzurufen, die eine Person hochgeladen hat, oder an /{user-id}/videos?type=tagged, um alle Videos abzurufen, in denen eine Person markiert wurde.

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

Wenn der Vorgang erfolgreich verläuft, erhält deine App diese Antwort:

{
  "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": "..."
    }
  }
}

Einschränkungen

  • Standardmäßig werden mit einer GET-Anfrage ohne Angabe eines type Videos zurückgegeben, in denen eine Person markiert wurde.
  • Wird keine description zurückgegeben, enthielt der Videobeitrag keinen begleitenden Text.

Siehe auch