Rilevamento del diritto d'autore

Questa guida ti mostra come rilevare violazioni del diritto d'autore per un video caricato o pubblicato su Instagram usando l'API Instagram Graph.

Prima di iniziare

Prima di iniziare avrai bisogno di:

• Si applicano tutti i requisiti e le limitazioni per l'accesso agli endpoint del Contenitore di Instagram Container e del Contenuto multimediale di Instagram

Best practice

Controllare un video caricato

Per controllare lo stato del diritto d'autore di un video caricato, ma non ancora pubblicato, invia una richiesta GET all'endpoint /{ig-containter-id} con il parametro fields impostato su copyright_check_status.

Esempio di richiesta

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

In caso di azione eseguita correttamente, l'app riceve una risposta JSON con un oggetto copyright_check_status contenente la seguente coppia chiave-valore:

• status impostato su completed, error, in_progress o not_started
• matches_found impostato su:

  • false se non viene rilevata alcuna violazione
  • true se vengono rilevate violazioni e i valori author, content_title, matched_segments e owner_copyright_policy

Esempio di risposte

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

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

Controllare un video pubblicato

Per controllare lo stato del diritto d'autore di un video pubblicato, invia una richiesta GET all'endpoint /{ig-media-id} con il parametro fields impostato su copyright_check_information.

Esempio di richiesta

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

In caso di azione eseguita correttamente, l'app riceve una risposta JSON con l'id impostato sul video controllato e l'oggetto copyright_check_information con i valori seguenti:

• status impostato su un oggetto status che può essere completed, error, in_progress o not_started
• copyright_matches impostato su:

  • false: restituito quando non viene rilevata alcuna violazione del diritto d'autore
  • true: restituito quando vengono rilevate violazioni del diritto d'autore e include l'oggetto copyright_check_information che contiene informazioni sul proprietario del diritto d'autore, sulla normativa, sulle misure di mitigazione e sulle sezioni del contenuto multimediale che hanno violato il diritto d'autore.

Esempio di risposte

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

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

Altri contenuti da consultare

• Riferimento per contenitore di Instagram
• Riferimento per contenuto multimediale di Instagram