Instagram-Plattform

Ermittlung von Urheberrechten

Dieser Leitfaden zeigt dir, wie du Urheberrechtsverstöße für ein Video prüfen kannst, das über die Instagram Graph API auf Instagram hochgeladen und veröffentlicht wurde.

Wir unterstützen nur Instagram-Medien, die über die Content Publishing API zur frühzeitigen Urheberrechtserkennung erstellt wurden.

Bevor du beginnst

Bevor du beginnst, benötigst du Folgendes:

  • Es gelten alle Anforderungen und Einschränkungen für den Zugriff auf die IG-Container und -Medien-Endpunkte.

Best Practices

Wenn du einen API-Aufruf testest, kannst du den access_token-Parameter einbeziehen, der auf deinen Zugriffsschlüssel festgelegt ist. Wenn du jedoch sichere Aufrufe über deine App ausführst, verwende die Klasse des Zugriffsschlüssels.

Ein hochgeladenes Video prüfen

Um den Urheberrechtsstatus für ein Video zu überprüfen, das hochgeladen, aber noch nicht veröffentlicht wurde, sendest du eine GET-Anfrage an den /{ig-containter-id}-Endpunkt, wobei der fields-Parameter auf copyright_check_status festgelegt ist.

Beispielanfrage

curl -i -X GET "https://graph.facebook.com/v21.0/{ig-containter-id}?fields=copyright_check_status"

Wenn der Vorgang erfolgreich verläuft, erhält deine App eine JSON-Antwort mit einem copyright_check_status-Objekt, welches die folgenden Schlüssel-Wert-Paare enthält:

  • status festgelegt auf completed, error, in_progress oder not_started
  • matches_found festgelegt auf:
    • false, wenn keine Verstöße erkannt wurden
    • true, wenn Verstöße erkannt und außerdem die Werte author, content_title, matched_segments und owner_copyright_policy

Beispielantworten

Verstoß gefunden

{
  "copyright_check_status": {
    "status": "complete",
    "matches_found": true
  },
  "id": "{ig-containter-id}"
}

Kein Verstoß gefunden

{
  "copyright_check_status": {
      "status": "in_progress",
      "matches_found": false
  }
}

Ein veröffentlichtes Video prüfen

Um den Urheberrechtsstatus für ein veröffentlichtes Video zu überprüfen, sendest du eine GET-Anfrage an den /{ig-media-id}-Endpunkt, wobei der fields-Parameter auf copyright_check_information festgelegt ist.

Beispielanfrage

curl -i -X GET "https://graph.facebook.com/v21.0/{ig-media-id}?fields=copyright_check_information"

Bei Erfolg erhält deine App eine JSON-Antwort mit der id, die auf das überprüfte Video festgelegt ist, und mit dem Objekt copyright_check_information, für das Folgendes festgelegt ist:

  • status festgelegt auf ein status-Objekt mit dem Zustand completed, error, in_progress oder not_started
  • copyright_matches festgelegt auf:
    • false – wird zurückgegeben, wenn keine Urheberrechtsverstöße gefunden wurden
    • true – wird zurückgegeben, wenn Urheberrechtsverletzungen festgestellt werden, und enthält das Objekt copyright_check_information, das Informationen über den Urheberrechtsinhaber, Richtlinien, Behebungsmaßnahmen und Abschnitte der Medien enthält, die gegen das Urheberrecht verstoßen haben.

Beispielantworten

Verstoß gefunden

{
  "copyright_check_information": {
     "status": {
       "status": "complete",
       "matches_found": true
     },
     "copyright_matches": [
       {
         "content_title": "In My Feelings",
         "author": "Drake",
         "owner_copyright_policy": {
           "name": "UMG",
           "actions": [
             {
               "action": "BLOCK",
               "territories": "3",
               "geos": [
                 "Canada",
                 "India",
                 "United States of America"
               ]
             },
             {
               "action": "MUTE",
               "territories": "4",
               "geos": [
                 "Taiwan",
                 "Tanzania",
                 "Saudi Arabia",
                 "United Kingdom of Great Britain and Northern Ireland"
               ]
             }
           ]
         },
         "matched_segments": [
          {
            "start_time_in_seconds": 2.4,
            "duration_in_seconds": 5.1,
            "segment_type": "AUDIO"
          },
          {
            "start_time_in_seconds": 10.2,
            "duration_in_seconds": 4.5,
            "segment_type": "VIDEO"
          }
        ]
      }
    ]
  },
  "id": "90012800291314"
}

Kein Verstoß gefunden

{
  "copyright_check_information": {
    "status": {
      "status": "complete",
      "matches_found": false
    }
  },
  "id": "{ig-media-id}"
}

Siehe auch