Video API

Rights Manager API

Mit unserer Rights Manager API können Herausgeber Urheberrechte für Videos beanspruchen und Abgleichsregeln für Urheberrechte mit zwei neuen Endpunkten verwalten: video_copyright_rule und video_copyright.

Berechtigungen

Um diese API zu nutzen, musst du dich für Zugang zum Rights Manager-Tool bewerben (du musst bei Facebook angemeldet sein, um dieses Tool verwenden zu können). Weitere Informationen zum Rights Manager findest du unter rightsmanager.fb.com.

Urheberrecht bei Videos

Die Rights Manager API kann nur auf Videoinhalte auf Seiten angewendet werden. Alle Seiten müssen den Anmeldungsprozess durchlaufen haben, damit sie für die Verwendung der API infrage kommen.
Bevor du Urheberrechte für ein Video beanspruchen kannst, musst du Videoinhalte auf einer Facebook-Seite erstellen. Nutze hierzu die Video Upload API oder die Live Video API.

Befolge bei Videos folgende Schritte:

  1. Lade ein Video auf Facebook hoch und rufe die Video-ID ab.
  2. Nutze die Rights Manager API, um das Urheberrecht für das Video zu beanspruchen.

Befolge bei Live-Videos folgende Schritte:

  1. Erstelle ein live_video-Objekt und rufe die Live-Video-ID ab.
  2. Nutze die Rights Manager API, um das Urheberrecht für das Live-Video zu beanspruchen.
  3. Beginne, mit deiner Streaming-Software zu streamen.

Nur Referenz

Wenn das Video nur als Referenzvideo und nicht für die öffentliche Verbreitung auf Facebook genutzt werden soll, musst du das Video mit dem Parameter reference_only hochladen und die Rights Manager API mit dem is_reference_video-Parameter aufrufen. Achte beim Streamen darauf, dass du Rights Manager mit „is_reference_video“ aufrufst, bevor du den Stream startest. Das Video oder das Live-Video wird nicht in deiner Videobibliothek angezeigt. Es ist nur für den Administrator im Abschnitt „Referenzdateien“ des Rights Manager-Tools sichtbar.

Informationen zu den video_copyright_rule- und video_copyright-Endpunkten

  • video_copyright_rule-Endpunkt: Dieser Endpunkt ermöglicht die Erstellung einer Urheberrechtsregel. Du kannst beispielsweise festlegen, unter welchen Bedingungen eine Urheberrechtsmeldung ausgelöst und welche Aktion ausgeführt werden soll.

  • video_copyright-Endpunkt: Über diesen Endpunkt kannst du für ein bestimmtes Video Urheberrecht beanspruchen. Hier kannst du auch Urheberrechte festlegen und eine Urheberrechtsregel anwenden.

Der video_copyright_rule-Endpunkt

Über den video_copyright_rule-Endpunkt kannst du Urheberrechtsregeln erstellen, die bestimmen, welche Aktionen bei einem Video ausgeführt werden, wenn es mit den Regeln übereinstimmt. Als Rechteinhaber kannst du beispielsweise eine eigene Urheberrechtsregel erstellen, die die Nutzung deiner Videos für drei Minuten zulässt.

Es gibt verschiedene Arten von Bedingungen:

  • GEO: Bestimmt, ob das Video an einem bestimmten Standort verfügbar ist. Wenn ein Video beispielsweise im Vereinigten Königreich angezeigt werden kann und die Bedingung „VK und USA“ lautet, erfüllt das Video die Bedingung.
  • OVERLAP_DURATION: Bestimmt, wie lang die Übereinstimmung auftritt (z. B. über/unter 2 oder 3 Minuten)
  • MATCH_OVERLAP_PERCENTAGE: Bestimmt, welcher Prozentsatz des Videos übereinstimmt (über/unter 20 % des übereinstimmenden Videos).
  • REFERENCE_OVERLAP_PERCENTAGE: Bestimmt, welcher Prozentsatz deiner Referenzdatei übereinstimmt (z. B. über/unter 50 %).
  • MONITORING_TYPE: Bestimmt, ob Video, Audio oder beides übereinstimmt.
  • PUBLISHER_TYPE: Bestimmt, ob das übereinstimmende Video zu einer Seite, einem Profil oder beidem gehört.
  • PRIVACY: Bestimmt, ob das übereinstimmende Video öffentlich oder nicht öffentlich ist. Nicht öffentliche Video erreichen nur ein eingeschränktes Publikum. Wenn ein Video beispielsweise nur für Freunde einer Person oder eine bestimmte Gruppe sichtbar ist, ist es nicht öffentlich.

Es sind vier Handlungstypen verfügbar:

  • TRACK: Mit dieser Aktion kannst du das übereinstimmende Video verfolgen, ohne eine Aktion damit durchzuführen. Künftig wirst du auch Einblicke zum übereinstimmenden Video erhalten.
  • MONETIZE: Mit dieser Aktion kannst du an Werbeeinnahmen teilhaben, die ein Video generiert. Hierzu musst du über den Rights Manager-Abschnitt deiner Seiteneinstellungen Zahlungen einrichten.
  • BLOCK: Wenn du ein Video blockierst, ist es in keiner Region sichtbar, in der du über das Urheberrecht verfügst.
  • MANUAL_REVIEW: Durch diese Aktion wird die Übereinstimmung an den Abschnitt „Manuelle Überprüfung“ in Rights Manager gesendet, damit du manuell eine Aktion auf das übereinstimmende Video anwenden kannst. Übereinstimmungen im Abschnitt „Manuelle Überprüfung“ laufen nach 30 Tagen ab.

Erstellen einer Urheberrechtsregel

Du kannst eine Urheberrechtsregel erstellen, indem du mit folgendem Pfad eine POST-Anfrage an die video_copyright_rules-Edge sendest: POST/{pageid}/video_copyright_rules.

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyright_rules' \
 -F 'access_token=XXXXXXXX' \
 -F 'name="testrule"' \
 -F 'condition_groups=[{action:"MANUAL_REVIEW",conditions:[{type:"MONITORING_TYPE",operator:"IS",value:"VIDEO_ONLY"},{type:"OVERLAP_DURATION",operator:"LESS_THAN",value:120000},{type:"GEO",operator:"IN_SET",value:["AR","AU"]}]}]'

Lesen einer Urheberrechtsregel

Sende eine GET /video_copyright_rule_id request, um weitere Informationen zur Urheberrechtsregel zu erhalten.

** Beachte, dass in diesem Beispiel 576407315867188 für die ID der Urheberrechtsregel steht.

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?&access_token=XXXXXXXX' \

Löschen einer Urheberrechtsregel

Du kannst ein Live-Video löschen, indem du eine DELETE /video_copyright_rule_id-Anfrage sendest.

Der video_copyright-Endpunkt

Mit dem video_copyright-Endpunkt kannst du festlegen, für welches Video du Urheberrecht beanspruchen möchtest. Über diesen Endpunkt kannst du andere Seiten oder Nutzer auf eine Whitelist setzen, damit sie das Referenzvideo nutzen können. Wenn du beispielsweise über drei Seiten verfügst und für ein bestimmtes Video, das auf all deinen Seiten angezeigt werden soll, Urheberrecht beanspruchen möchtest, kannst du diese Seiten auf die Whitelist setzen.

Erstellen eines video_copyright-Endpunkts

Du kannst eine POST-Anfrage mit folgenden Pfaden an die video_copyrights-Edge senden: /{page_id}/video_copyrights.

** Beachte, dass in diesem Beispiel 576425449198708 für die Video-ID steht, die das zu schützende Video beschreibt.

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyrights' \
-F  'access_token=XXXXXXXX' \
-F  'copyright_content_id=576425449198708' \
-F  'is_reference_video=true' \
-F  'monitoring_type=VIDEO_ONLY' \
-F  'rule_id=576407315867188' \
-F  'whitelisted_ids=[139577256378818]' \
-F  'ownership_countries=[“us”,”ca”]' \
Return values: Video copyright id.
{"id":"576425925865327"}

Du kannst bei jedem beliebigen Video das Feld „copyright“ abfragen, um weitere Informationen zum video_copyright-Node zu erhalten.

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?fields=copyright&access_token=XXXXXXXX' \

Für den video_copyright-Endpunkt stehen auch Features zum Aktualisierungen, Lesen und Löschen zur Verfügung. Weitere Informationen findest du im entsprechenden Abschnitt der Dokumentation zu Endpunkten beim Videourheberrecht.