API Video

API Rights Manager

Với API Rights Manager, các nhà phát hành có thể xác nhận quyền sở hữu bản quyền đối với video và quản lý quy tắc khớp bản quyền bằng 2 điểm cuối mới: điểm cuối video_copyright_rule và điểm cuối video_copyright.

Các quyền

Để sử dụng API này, bạn cần đăng ký quyền truy cập vào công cụ Rights Manager (bạn phải đăng nhập Facebook để sử dụng công cụ này). Bạn có thể đọc thêm và tìm hiểu về Rights Manager trong rightsmanager.fb.com.

Giữ quyền tác giả video

Chỉ có thể áp dụng API Rights Manager cho các video trên trang. Cần phải tiến hành đăng ký tất cả các trang để đủ điều kiện sử dụng API.
Trước khi có thể giữ quyền tác giả video, bạn phải tạo nội dung video trên Trang Facebook. Bạn có thể thực hiện điều này thông qua API Tải lên video hoặc API Video trực tiếp.

Đối với video, thực hiện các bước sau:

  1. Tải video lên Facebook và nhận id video.
  2. Sử dụng API Rights Manager để giữ quyền tác giả video.

Đối với video trực tiếp, thực hiện các bước sau:

  1. Tạo đối tượng live_video và nhận id video trực tiếp.
  2. Sử dụng API Rights Manager để giữ quyền tác giả video trực tiếp.
  3. Bắt đầu phát trực tiếp bằng phần mềm phát trực tiếp của bạn.

Chỉ để tham khảo

Nếu video chỉ được dùng làm video tham khảo và không nhằm mục đích tiêu thụ và phân phối trên Facebook, thì bạn nên tải video lên bằng cách sử dụng thông số "reference_only" và cần gọi API Rights Manager bằng thông số is_reference_video. Khi phát trực tiếp, bạn chỉ cần đảm bảo gọi Rights Manager có "is_reference_video" trước khi phát trực tiếp. Video hoặc video trực tiếp sẽ không xuất hiện trong Thư viện video của bạn và sẽ chỉ hiển thị với Quản trị viên, trong phần File tham chiếu của công cụ Rights Manager.

Tìm hiểu các điểm cuối video_copyright_rule và video_copyright

  • Điểm cuối video_copyright_rule: Điểm cuối này cho phép bạn tạo quy tắc bản quyền. Ví dụ: bạn có thể xác định điều kiện kích hoạt báo cáo bản quyền và loại hành động cần thực hiện.

  • Điểm cuối video_copyright: Bạn có thể sử dụng điểm cuối này để giữ quyền tác giả một video cụ thể. Bạn cũng có thể chỉ định quyền sở hữu bản quyền và áp dụng quy tắc bản quyền tại đây.

Điểm cuối video_copyright_rule

Điểm cuối video_copyright_rule cho phép bạn tạo quy tắc bản quyền để xác định những hành động sẽ thực hiện đối với video khớp với những quy tắc này. Ví dụ: với tư cách người nắm giữ bản quyền, bạn có thể tạo quy tắc bản quyền để cho phép sử dụng video không quá 3 phút.

Có một số loại điều kiện:

  • GEO: Xác định liệu có xem được video ở một vị trí nhất định không. Ví dụ: nếu có thể xem video ở Vương quốc Anh và điều kiện địa lý là "Vương quốc Anh và Hoa Kỳ", thì video đáp ứng điều kiện.
  • OVERLAP_DURATION: Xác định thời lượng khớp (ví dụ: trên hoặc dưới 2 hoặc 3 phút)
  • MATCH_OVERLAP_PERCENTAGE: Xác định phần trăm khớp của video trùng khớp (ví dụ: lớn hơn hoặc nhỏ hơn 20% của video trùng khớp)
  • REFERENCE_OVERLAP_PERCENTAGE: Xác định phần trăm khớp của file tham chiếu (ví dụ: trên hoặc dưới 50%)
  • MONITORING_TYPE: Xác định xem video, âm thanh khớp hay cả video và âm thanh đều khớp
  • PUBLISHER_TYPE: Video đã khớp thuộc sở hữu của Trang, Trang cá nhân hay cả hai.
  • PRIVACY: Xác định xem video trùng khớp là công khai, không công khai hay cả hai. Video không công khai có đối tượng giới hạn. Ví dụ: video hiển thị với bạn bè của một người hoặc một nhóm là video không công khai.

Có bốn loại hành động khả dụng:

  • TRACK: Hành động này cho phép bạn theo dõi video trùng khớp mà không cần thực hiện bất kỳ hành động nào. Trong tương lai, bạn cũng có thể xem thông tin chi tiết về video trùng khớp.
  • MONETIZE: Hành động này cho phép bạn tăng doanh thu quảng cáo từ video. Hành động này yêu cầu bạn thiết lập Thanh toán. Bạn có thể thực hiện thao tác này từ phần Rights Manager của Cài đặt Trang.
  • BLOCK: Chặn video nghĩa là video sẽ không hiển thị ở bất kỳ vị trí địa lý nào mà bạn sở hữu video
  • MANUAL_REVIEW: Hành động này sẽ gửi video trùng khớp đến phần Xét duyệt thủ công của Rights Manager để bạn có thể áp dụng hành động theo cách thủ công đối với video trùng khớp. Video trùng khớp trong phần xét duyệt thủ công của bạn sẽ hết hạn sau 30 ngày.

Tạo quy tắc bản quyền

Bạn có thể tạo quy tắc bản quyền bằng cách thực hiện yêu cầu POST tới cạnh video_copyright_rules theo đường dẫn sau: 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"]}]}]'

Đọc quy tắc bản quyền

Phát hành GET /video_copyright_rule_id request để nhận thêm thông tin về quy tắc bản quyền.

** Trong ví dụ này, lưu ý rằng 576407315867188 là ID quy tắc bản quyền.

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

Xóa quy tắc bản quyền

Bạn có thể xóa video trực tiếp bằng cách tạo yêu cầu DELETE /video_copyright_rule_id.

Điểm cuối video_copyright

Điểm cuối video_copyright cho phép bạn chỉ định video mà bạn muốn giữ quyền tác giả. Từ điểm cuối này, bạn có thể đưa các trang hoặc người dùng khác vào danh sách hợp lệ để sử dụng video tham khảo. Ví dụ: nếu bạn có 3 trang và muốn giữ quyền tác giả một video nhất định để có thể phát trên tất cả các trang, thì bạn có thể chỉ định những trang đó trong danh sách hợp lệ.

Tạo điểm cuối video_copyright

Bạn có thể tạo yêu cầu POST đến cạnh video_copyrights từ đường dẫn sau: /{page_id}/video_copyrights

** Trong ví dụ này, lưu ý rằng 576425449198708 là ID video đại diện cho video có bản quyền.

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

Đối với bất kỳ video cụ thể nào, bạn có thể truy vấn trường "bản quyền" để nhận thêm thông tin về nút video_copyright.

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

Các chức năng Cập nhật, Đọc và Xóa cũng khả dụng cho điểm cuối video_copyright. Để biết thêm thông tin, vui lòng tham khảo tài liệu về điểm cuối dành cho bản quyền video.