API วิดีโอ

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 วิดีโอถ่ายทอดสด

ขั้นตอนสำหรับวิดีโอมีดังนี้

  1. อัพโหลดวิดีโอไปยัง Facebook แล้วรับรหัสวิดีโอ
  2. ใช้ Rights Manager API เพื่อปกป้องลิขสิทธิ์ของวิดีโอ

ขั้นตอนสำหรับวิดีโอถ่ายทอดสดมีดังนี้

  1. สร้างอ็อบเจกต์ live_video แล้วรับรหัสวิดีโอถ่ายทอดสด
  2. ใช้ Rights Manager API เพื่อปกป้องลิขสิทธิ์ของวิดีโอถ่ายทอดสด
  3. เริ่มการสตรีมโดยใช้ซอฟต์แวร์การสตรีม

สำหรับการอ้างอิงเท่านั้น

หากต้องใช้วิดีโอเป็นวิดีโออ้างอิงเท่านั้นและไม่ได้มีไว้เพื่อการบริโภคและการแจกจ่ายบน Facebook ให้อัพโหลดวิดีโอโดยใช้พารามิเตอร์ "reference_only" และต้องเรียกใช้ Rights Manager API โดยใช้พารามิเตอร์ is_reference_video ในการสตรีม เพียงตรวจสอบว่าคุณเรียกใช้ Rights Manager กับ “is_reference_video” แล้ว ก่อนเริ่มการสตรีม วิดีโอหรือวิดีโอถ่ายทอดสดจะไม่ปรากฏในไลบรารีวิดีโอของคุณ และจะมีเฉพาะผู้ดูแลเท่านั้นที่สามารถมองเห็นได้ในส่วน “ไฟล์อ้างอิง” ของเครื่องมือ 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 เป็น ID กฎการปกป้องลิขสิทธิ์

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

การลบกฎการปกป้องลิขสิทธิ์

คุณสามารถลบวิดีโอถ่ายทอดสดได้โดยการส่งคำขอ DELETE /video_copyright_rule_id

ตำแหน่งข้อมูล video_copyright

ตำแหน่งข้อมูล video_copyright จะช่วยในการระบุวิดีโอที่คุณต้องการปกป้องลิขสิทธิ์ จากตำแหน่งข้อมูลนี้ คุณสามารถไวท์ลิสต์เพจหรือผู้ใช้อื่นๆ ที่จะใช้วิดีโออ้างอิงได้ ยกตัวอย่างเช่น หากคุณมีเพจ 3 เพจและต้องการปกป้องลิขสิทธิ์ของวิดีโอบางรายการให้เล่นได้บนเพจทุกเพจของคุณ คุณจะสามารถระบุเพจเหล่านั้นได้ในไวท์ลิสต์

การสร้างตำแหน่งข้อมูล video_copyright

คุณสามารถส่งคำขอ POST ไปยังจุดเชื่อมโยง video_copyrights ได้จากพาธต่อไปนี้: /{page_id}/video_copyrights

** โปรดทราบว่าในตัวอย่างนี้ 576425449198708 เป็น ID วิดีโอที่แสดงวิดีโอที่ต้องการปกป้องลิขสิทธิ์

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&access_token=XXXXXXXX' \

ความสามารถในการอัพเดต การอ่าน และการลบก็พร้อมให้ใช้งานที่ตำแหน่งข้อมูล video_copyright แล้วด้วยเช่นกัน โปรดดูข้อมูลเพิ่มเติมที่เอกสารประกอบตำแหน่งข้อมูลที่ต้องการปกป้องลิขสิทธิ์ในวิดีโอ