著作権検出

このガイドでは、InstagramグラフAPIを使用してInstagramにアップロードまたは公開された動画の著作権侵害を検出する方法を説明します。

著作権の早期検出のために、コンテンツ公開APIで作成されたInstagramメディアのみをサポートしています。

開始する前に

始める前に、次のものが必要です。

• InstagramコンテナおよびInstagramメディアのエンドポイントにアクセスするためのすべての要件と制限が適用されます。

ベストプラクティス

アップロードされた動画のチェック

アップロードされているがまだ公開されていない動画の著作権ステータスをチェックするには、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"
    

成功すると、アプリは次のキー/値ペアを含むcopyright_check_statusオブジェクトがあるJSON応答を受け取ります。

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

参考情報

• Instagramコンテナリファレンス
• Instagramメディアリファレンス