Instagram 平台

版權偵測

本指南講解如何使用 Instagram Graph API 偵測已在 Instagram 上載和發佈的影片有沒有侵犯版權。

我們僅支援對透過內容發佈 API 建立的 Instagram 媒體進行早期版權偵測。

準備工作

建立之前，您需要準備以下事項：

  • 遵守在存取 Instagram 容器和 Instagram 媒體兩個端點時所規定的所有要求和限制

最佳操作實例

測試 API 呼叫時，您可以在呼叫中加入 access_token 參數，並將其設為您的存取憑證。但是，從您的應用程式發出安全呼叫時，應使用存取憑證類別。

檢查已上載的影片

如要就已上載但尚未發佈的影片檢查版權狀態，請向 /{ig-containter-id} 端點傳送 GET 要求，並在當中加入設為 copyright_check_status 的 fields 參數。

要求範例

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 要求，並在當中加入設為 copyright_check_information 的 fields 參數。

要求範例

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

另請參閱