Rights Manager API

权限

要使用此 API，您需要申请 Rights Manager 工具访问权限（必须登录 Facebook 才能使用此工具）。如需详细了解 Rights Manager，请访问 rightsmanager.fb.com。

获取视频版权

Rights Manager API 仅可应用于主页上的视频。所有主页都必须完成报名流程才有资格使用该 API。
您应首先在 Facebook 主页上创建视频内容，然后才能获取视频版权。此操作可通过视频上传 API 或直播视频 API 完成。

对于视频，步骤如下：

将视频上传到 Facebook 并获取视频编号。
使用 Rights Manager API 获取视频版权。

对于直播视频，步骤如下：

创建 live_video 对象并获取直播视频编号。
使用 Rights Manager API 获取直播视频版权。
使用直播软件开始直播。

仅供参考

如果视频仅应用作参考视频，而不应在 Facebook 上消费和传播，则应使用“reference_only”参数上传视频，且需要使用 is_reference_video 参数调用 Rights Manager API。直播时，只需在开始直播前确保使用“is_reference_video”调用 Rights Manager 即可。视频或直播视频不会在视频库中显示，且仅在 Rights Manager 工具的“参照文件”版块中对管理员可见。

了解 `video_copyright_rule` 和 `video_copyright` 端点

video_copyright_rule 端点：您可借助此端点创建版权规则。例如，您可以确定应在哪种条件下触发版权报告以及应采取哪种操作。
video_copyright 端点：您可使用此端点获取特定视频的版权。您还可使用此端点指定版权所有权及应用版权规则。

`video_copyright_rule` 端点

借助 video_copyright_rule 端点，您可创建版权规则，确定对匹配这些规则的视频采取哪些操作。例如，作为权利所有人，您可创建一条版权规则，允许使用您的视频不超过 3 分钟。

我们提供多种条件类型：

GEO：确定视频是否在特定地区可用。例如，如果可在英国查看某个视频，而地理位置条件为“英国和美国”，则该视频满足条件。
OVERLAP_DURATION：确定匹配时长（例如，长于/短于 2 分钟或 3 分钟）
MATCH_OVERLAP_PERCENTAGE：确定匹配视频的匹配率（例如，多于或少于匹配视频的 20%）
REFERENCE_OVERLAP_PERCENTAGE：确定参照文件的匹配率（例如，多于或少于 50%）
MONITORING_TYPE：确定是视频还是音频匹配，还是两者皆匹配
PUBLISHER_TYPE：匹配视频是为某个公共主页或个人主页所有，或者同时具备这两种属性。
PRIVACY：确定匹配视频是公开视频还是非公开视频，或者同时具备这两种属性。非公开视频的分享对象受限。例如，对用户的好友或小组可见的视频为非公开视频。

我们提供四种操作类型：

TRACK：借助此操作，您可跟踪匹配的视频，而不对该视频采取任何操作。未来，您还将能够查看有关匹配视频的成效分析。
MONETIZE：借助此操作，您可分享视频生成的广告收入。这需要您先设置支付功能，该功能可通过“主页设置”的“Rights Manager”版块设置。
BLOCK：屏蔽某个视频意味着该视频在您拥有此视频权限的所有地理位置都不可见
MANUAL_REVIEW：此操作会将匹配项发送到 Rights Manager 的“手动审核”板块，方便您对匹配的视频手动应用操作。“手动审核”版块中的匹配项会在 30 天内过期。

创建版权规则

您可使用以下路径向 video_copyright_rules 连线发出 POST 请求以创建版权规则：POST/{pageid}/video_copyright_rules。

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyright_rules' \
 -F 'access_token=XXXXXXXX' \
 -F 'name="testrule"' \
 -F 'condition_groups=[{action:"MANUAL_REVIEW",conditions:[{type:"MONITORING_TYPE",operator:"IS",value:"VIDEO_ONLY"},{type:"OVERLAP_DURATION",operator:"LESS_THAN",value:120000},{type:"GEO",operator:"IN_SET",value:["AR","AU"]}]}]'

读取版权规则

发出 GET /video_copyright_rule_id request 以获取有关版权规则的详细信息。

**请注意，在此示例中，576407315867188 是版权规则编号。

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?&amp;access_token=XXXXXXXX' \

删除版权规则

您可发出 DELETE /video_copyright_rule_id 请求，删除直播视频规则。

`video_copyright` 端点

借助 video_copyright 端点，您可指定想要获取版权的视频。通过此端点，您可将其他主页或用户加入参照视频的使用白名单。例如，如果您拥有 3 个主页并想要获取特定视频的版权，以便能够在这些主页上播放，您可在白名单中指定这些主页。

创建 `video_copyright` 端点

您可通过以下路径向 video_copyrights 连线发出 POST 请求：/{page_id}/video_copyrights

**请注意，在此示例中，576425449198708 是视频编号，代表要获取版权的视频。

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyrights' \
-F  'access_token=XXXXXXXX' \
-F  'copyright_content_id=576425449198708' \
-F  'is_reference_video=true' \
-F  'monitoring_type=VIDEO_ONLY' \
-F  'rule_id=576407315867188' \
-F  'whitelisted_ids=[139577256378818]' \
-F  'ownership_countries=[“us”,”ca”]' \
Return values: Video copyright id.
{"id":"576425925865327"}

对于任何给定视频，您可查询“copyright”字段，获取有关 video_copyright 节点的详细信息。

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?fields=copyright&amp;access_token=XXXXXXXX' \