저작권 감지

이 가이드에서는 Instagram 그래프 API를 사용하여 Instagram에 업로드 또는 게시된 동영상의 저작권 위반을 감지하는 방법을 보여줍니다.

Meta에서는 조기에 저작권 위반을 감지하기 위해 콘텐츠 게시 API를 통해 만든 Instagram 미디어만 지원합니다.

시작하기 전에

시작하기 전에 다음과 같은 항목이 필요합니다.

  • Instagram 컨테이너 및 Instagram 미디어 엔드포인트에 액세스하기 위한 모든 요구 사항과 제한 사항이 적용됩니다.

모범 사례

API 호출을 테스트할 때 액세스 토큰으로 설정된 access_token 매개변수를 포함할 수 있습니다. 그러나 앱에서 보안 호출을 수행할 때는 액세스 토큰 클래스를 사용합니다.

업로드된 동영상 확인

업로드되었지만 아직 게시되지 않은 동영상의 저작권 상태를 확인하려면 /{ig-containter-id} 엔드포인트로 GET 요청을 보냅니다. 이때 fields 매개변수는 copyright_check_status로 설정합니다.

요청 샘플

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

요청에 성공하면 앱이 다음과 같은 키-값 쌍을 포함한 copyright_check_status 개체와 함께 JSON 응답을 받게 됩니다.

  • completed, error, in_progress 또는 not_started로 설정된 status
  • 다음으로 설정된 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
  }
}

게시된 동영상 확인

게시된 동영상의 저작권 상태를 확인하려면 /{ig-media-id} 엔드포인트로 GET 요청을 보냅니다. 이때 fields 매개변수를 copyright_check_information으로 설정합니다.

요청 샘플

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

요청에 성공하면 앱이 확인 대상인 동영상으로 설정된 id 및 다음을 포함한 copyright_check_information 개체와 함께 JSON 응답을 받게 됩니다.

  • completed, error, in_progress 또는 not_started로 설정된 status 개체로 설정된 status
  • 다음으로 설정된 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}"
}