Rights Manager API

藉由兩個新端點（video_copyright_rule 端點和 video_copyright 端點），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 個粉絲專頁，並且想要主張特定影片著作權，使得該影片能夠在這 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' \