Video API

Ein Video crossposten

In diesem Dokument erfährst du, wie du mit der Video API ein Video auf mehreren Seiten veröffentlichen kannst, ohne das Video auf jede einzelne Seite hochzuladen. Wenn du beispielsweise über eine übergeordnete Seite mit mehreren untergeordneten Seiten verfügst, kannst du ein Video auf die übergeordnete Seite hochladen und dort veröffentlichen und dann das Video auf allen untergeordneten Seiten veröffentlichen, ohne das Video auf jede einzelne Seite hochladen zu müssen.

Um ein Video an mehreren Stellen veröffentlichen zu können, musst du die CREATE-Aufgabe für die Seiten ausführen und das Video für die Veröffentlichung auf bestimmten Seiten aktivieren. Du benötigst die ID des Videos und die IDs der Seiten, auf denen du das Video veröffentlichen möchtest, sowie die Seiten-Zugriffsschlüssel von der Seite, auf der das Video ursprünglich veröffentlicht wurde, sowie der Seiten, auf denen du veröffentlichen möchtest.

Mit der API kannst du ermitteln, ob ein Video bereits für Crossposten aktiviert oder an mehreren Stellen gepostet wurde, wie du Crossposten für alle von deinem Business Manager verwalteten Seiten aktivieren kannst und wie du eine Liste mit Seiten abrufen kannst, auf denen du crossposten kannst.

Informationen zum Crossposten eines Reels auf der Facebook-Seite eines*einer Collaborator*in findest du auf unserem Veröffentlichungsleitfaden zu Reels.

Einschränkungen

Wenn ein Video auf deiner Seite crossgepostet wurde, du jedoch über keine Rolle auf der Seite verfügst, auf der das Video ursprünglich veröffentlicht wurde, kannst du Berechtigungen für das Video nicht ändern.

Schritt 1: Crossposten aktivieren

Um ein Video auf mehreren Seiten zu veröffentlichen, musst du das Crossposten des Videos auf diesen Seiten aktivieren.

Voraussetzungen:

Sende eine POST-Anfrage an den Video-Endpunkt:

POST /{api-version}/{video-id}
  ?allow_crossposting_for_pages=[{page_id:{page-a-id},allow:true},{page_id:{page-b-id},allow:true}]
  &access_token={page-access-token}

Schließe die folgenden Parameter ein:

ParameternameWert

allow_crossposting_for_pages

Ein JSON-Array der Seiten-IDs, auf denen du das Video veröffentlichen möchtest. Lege allow auf true fest, um die Veröffentlichung zu aktivieren, oder auf false, um die Veröffentlichung zu deaktivieren.

access_token

Der Seiten-Zugriffsschlüssel der Seite, auf der das Video ursprünglich veröffentlicht wurde.

Beispielanfrage

curl -X POST \
  "https://graph.facebook.com/v7.0/2918040388250909" \
  -F "allow_crossposting_for_pages=[{page_id:104371193424796,allow:true},{page_id:115969103185286",allow:true}] \
  -F "access_token=EAABkW..."

Beispielantwort

{
  "success": true
}

Schritt 2: Videos crossposten

Voraussetzungen:

Sende eine POST-Anfrage an den Seiten-Videos-Endpunkt:

POST /{api-version}/{page-id}/videos
    ?crossposted_video_id={video-id}
    &access_token={page-access-token}

Schließe die folgenden Parameter ein:

ParameternameWert

crossposted_video_id

Die Video-ID des Videos, das du crosspostest.

access_token

Der Seiten-Zugriffsschlüssel der Seite, auf der du das Video veröffentlichst.

Beispielanfrage

curl -X POST \
  "https://graph.facebook.com/104371193424796/videos?crossposted_video_id=2918040388250909&access_token=EAABk..."

Beispiel einer JSON-Antwort

{
  "id":"577600939847873"
}

Crossposting-Eignung eines Videos abrufen

Sende eine GET-Anfrage an den Video-Endpunkt, um herauszufinden, ob ein Video für Crossposting geeignet ist. Die Anforderung muss das Feld is_crossposting_eligible enthalten.

Voraussetzungen:

GET /{api-version}/{video-id}
   ?fields=is_crossposting_eligible
   &access_token={page-access-token}

Beispielanfrage

curl -X GET \
  "https://graph.facebook.com/v7.0/2918040388250909" \
  -F "is_crossposting_eligible" \
  -F "access_token=EAABkW..."

Beispielantwort

{
  "is_crossposting_eligible": true,
  "id": "2918040388250909"
}
ParameternameWert

is_crossposting_eligible

Gibt an, ob das Video für Crossposting aktiviert ist.

access_token

Der Seiten-Zugriffsschlüssel der Seite, auf der das Video ursprünglich veröffentlicht wurde.

Crossposting-Status des Videos abrufen

Sende eine GET-Anfrage an den Video-Endpunkt, um herauszufinden, ob es sich bei einem Video um ein mehrfach gepostetes Video handelt. Die Anforderung muss das Feld is_crosspost_video enthalten.

Voraussetzungen:

GET /{api-version}/{video-id}
  ?fields=is_crosspost_video
  &access_token={page-access-token}

Schließe die folgenden Parameter ein

ParameternameWert

is_crosspost_video

Zeigt an, ob es sich um das Originalvideo oder ein crossgepostetes Video handelt.

access_token

Der Seiten-Zugriffsschlüssel der Seite, auf der das Video ursprünglich veröffentlicht wurde.

Beispielanfrage

curl -X GET \
 "https://graph.facebook.com/v7.0/577600939847873?fields=is_crosspost_video&access_token=EAABk..."

Beispielantwort

{
  "is_crosspost_video": true,
  "id": "577600939847873"
}

Eine Liste mit Seiten abrufen, die sich für Crossposten eignen

Voraussetzungen:

Sende eine GET-Anfrage an den Page CrosspostWhitelistedPages-Endpunkt.

GET {page-id}/crosspost_whitelisted_pages
  &access_token={page-access-token}

Beispielanfrage

curl -X GET \ "https://graph.facebook.com/v7.0/2918040388250909/crosspost_whitelisted_pages&access_token=EAABk..."

Beispielantwort

{
  "crosspost_whitelisted_pages": {
    "data": [
      {
        "name": "Obsession, by Margaret",
        "id": "115969103185286"
      },
      {
        "name": "Cisco Dog",
        "id": "422575694827569"
      }
    ],
    "paging": {
      "cursors": {
        "before": "QVFIUn...",
        "after": "QVFIUk4..."
      }
    }
  },
  "id": "1353269864728879"
}

Crossposten für alle deine Business Manager-Seiten aktivieren

Sende eine POST-Anfrage an den Video-Endpunkt, um Crossposten für alle Seiten zu aktivieren, die von deinem Business Manager verwaltet werden.

Voraussetzungen:

POST /{api-version}/{video-id}
  ?allow_bm_crossposting=true
  &access_token={page-access-token}

Schließe die folgenden Parameter ein

ParameternameWert

allow_bm_crossposting

Lege allow auf „true“ fest, um die Veröffentlichung zu aktivieren, oder auf „false“, um die Veröffentlichung zu deaktivieren.

access_token

Der Seiten-Zugriffsschlüssel der Seite, auf der das Video ursprünglich veröffentlicht wurde.

Beispielanfrage

curl -X POST \
  "https://graph.facebook.com/v7.0/2918040388250909?allow_bm_crossposting=true&access_token=EAABkW..."

Beispielantwort

{
  "success": true
}

Insights

Jedes crossgepostete Video verfügt über eine eindeutige video_id. Du kannst Video-Insights von jedem Video und jeder Seite abrufen.

Siehe auch

Weitere Informationen zum Crossposten findest du in unserem Hilfebereich.