Rights Manager API

我們的 Rights Manager API 能讓發佈商認領影片的擁有權，並管理版權配對規則，方法是使用以下兩個全新的端點：video_copyright_rule 端點和 video_copyright 端點。

權限

如要使用此 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 天後失效。

建立版權規則

您可以在下列路徑傳送 POST 要求至 video_copyright_rules 邊緣，以建立版權規則：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 個專頁，且希望為特定影片建立版權，以便在這 3 個專頁上播放此影片，則您可以在允許清單中指定這些專頁。

建立 `video_copyright` 端點

您可以從下列路徑傳送 POST 要求至 video_copyrights 邊緣：/{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"}

不論是哪一部影片，您都可以查詢「版權」欄位來取得更多有關 video_copyright 節點的資訊。

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

「更新」、「讀取」及「刪除」功能也適用於 video_copyright 端點。如需詳細資訊，請參閱影片版權端點文件。