Instagram 開放平台

著作權偵測

本指南說明如何使用 Instagram 圖形 API 偵測上傳或發佈到 Instagram 的影片著作權違規內容。

我們僅針對以內容發佈 API 建立的 Instagram 影音素材進行早期著作權偵測。

開始之前

開始之前，您需要以下必備資料：

  • 存取 Instagram 容器和 Instagram 影音素材端點的所有需求和限制均適用

最佳作法

測試 API 呼叫時，可以將 access_token 參數組合包含在存取權杖中。不過，從應用程式進行安全呼叫時，請使用存取權杖類別。

檢查已上傳影片

若要檢查已上傳但尚未發佈的影片著作權狀態，請向 /{ig-containter-id} 端點傳送 GET 要求，並將 fields 參數設為 copyright_check_status。

要求範例

curl -i -X GET "https://graph.facebook.com/v25.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
  }
}

檢查已發佈影片

若要檢查已發佈的影片著作權狀態，請向 /{ig-media-id} 端點傳送 GET 要求，並將 fields 參數設為 copyright_check_information。

要求範例

curl -i -X GET "https://graph.facebook.com/v25.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}"
}

另請參閱