Платформа Instagram

Проверка авторских прав

В этом руководстве рассказывается, как обнаруживать нарушение авторских прав для видео, загруженных или опубликованных в Instagram, с помощью Graph API для Instagram.

Раннее обнаружение нарушений авторских прав поддерживается только для медиафайлов Instagram, созданных через API для публикации контента.

Прежде чем начать

Вам понадобится:

  • соблюдать все требования и ограничения для доступа к конечным точкам Instagram Container и Instagram Media

Рекомендации

При тестировании вызова API можно добавить параметр access_token и задать в нем маркер доступа. Однако при выполнении безопасных вызовов из приложения следует использоваться класс маркера доступа.

Проверка загруженного видео

Чтобы проверить статус авторских прав для загруженного, но ещё не опубликованного видео, отправьте запрос GET к конечной точке /{ig-containter-id} и задайте для параметра fields значение copyright_check_status.

Пример запроса

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

В случае успеха приложение получит ответ JSON с объектом copyright_check_status, содержащим следующие пары "ключ-значение":

  • status со значением completed, error, in_progress или not_started
  • matches_found со значением:
    • false, если ничего не обнаружено
    • true, если обнаружены нарушения (в этом случае будут установлены значения author, content_title, matched_segments и owner_copyright_policy)

Примеры ответов

Обнаружено нарушение

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

Нарушений не обнаружено

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

Проверка опубликованного видео

Чтобы проверить статус авторских прав для опубликованного видео, отправьте запрос GET к конечной точке /{ig-media-id} и задайте для параметра fields значение copyright_check_information.

Пример запроса

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

В случае успеха приложение получит ответ JSON с проверяемым видео в параметре id и объектом copyright_check_information, содержащим следующие параметры:

  • status с объектом status и значением completed, error, in_progress или not_started
  • copyright_matches со значением:
    • false, если нарушения авторских прав не обнаружены
    • true, если обнаружено нарушение (в этом случае в объекте copyright_check_information будет содержаться информация о владельце авторского права, политике, действиях, которые необходимо предпринять для устранения нарушения, и разделах медиафайла, нарушающих авторское право).

Примеры ответов

Обнаружено нарушение

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

См. также