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"

若请求成功，应用收到的 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
  }
}

检查已发布的视频

如要检查已发布视频的版权状态，请向 /{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}"
}

另请参阅