ส่วนประกอบ
URL โฮสต์
https://graph-video.facebook.com— ใช้สำหรับการเผยแพร่วิดีโอบนเพจและกลุ่มโดยเฉพาะhttps://graph.facebook.com— ใช้สำหรับอย่างอื่นทั้งหมด (การสร้างโพลล์ การรับข้อมูลเชิงลึก ฯลฯ)
โปรโตคอลการอัพโหลด
API รองรับโปรโตคอลการอัพโหลดทั้งในแบบทำงานต่อจากที่ค้างได้และทำงานต่อจากที่ค้างไม่ได้ โปรโตคอลการอัพโหลดแบบทำงานต่อจากที่ค้างได้ใช้สำหรับการอัพโหลดกลุ่มข้อมูลวิดีโอ ในขณะที่โปรโตคอลการอัพโหลดแบบทำงานต่อจากที่ค้างไม่ได้ใช้สำหรับการอัพโหลดวิดีโอที่สมบูรณ์ เราขอแนะนำให้ใช้โปรโตคอลการอัพโหลดแบบทำงานต่อจากที่ค้างได้ เนื่องจากรองรับไฟล์วิดีโอที่มีขนาดใหญ่กว่าและช่วยให้คุณมีประสิทธิภาพมากกว่าในการจัดการกับการเชื่อมต่อที่หยุดชะงัก
ทรัพยากร
API ใช้โหนดต่อไปนี้
วิดีโอ
โหนดวิดีโอเป็นทรัพยากรหลักของ API เมื่อคุณอัพโหลดวิดีโอที่มีอยู่ API จะสร้างเอนทิตี้วิดีโอ และเผยแพร่บนเพจหรือกลุ่ม อย่างใดอย่างหนึ่ง ขึ้นอยู่กับโหนดที่คุณกำหนดเป้าหมายเมื่อเริ่มกระบวนการเผยแพร่ ทั้งนี้ จะต้องเผยแพร่วิดีโอบนโหนดเป้าหมาย
เพจ
การเผยแพร่วิดีโอบนกลุ่มสามารถทำได้ ตราบใดที่แอพมีสิทธิ์การอนุญาตและคุณสมบัติที่เหมาะสม นอกจากนี้ ผู้ใช้แอพจะต้องสามารถทำงานที่เทียบเท่าผู้ดูแลบนเพจนั้นได้ หรือได้รับมอบบทบาทผู้ดูแลบนเพจนั้นผ่านทางตัวจัดการธุรกิจ
กลุ่ม
การเผยแพร่วิดีโอบนกลุ่มสามารถทำได้ ตราบใดที่แอพมีสิทธิ์การอนุญาตและคุณสมบัติที่เหมาะสม และผู้ใช้แอพเป็นผู้ดูแลของกลุ่ม
วิดีโอที่โพสต์ข้ามเพจ
นอกจากนี้ คุณยังสามารถนำวิดีโอที่เผยแพร่แล้วไปเผยแพร่บนเพจอื่นๆ ที่ผู้ใช้แอพดูแลได้โดยไม่ต้องอัพโหลดซ้ำอีกด้วย ทั้งนี้ คุณสามารถส่งกลับข้อมูลเชิงลึกเกี่ยวกับวิดีโอที่โพสต์ข้ามเพจโดยเป็นค่ารวม (เช่น ผลรวมจำนวนการรับชมทั้งหมดในทุกเพจ) หรือแบ่งตามเพจก็ได้
สไลด์โชว์
คุณสามารถใช้ API เพื่อสร้างวิดีโอแบบสไลด์โชว์จากคอลเลกชันรูปภาพที่โฮสต์บนเซิร์ฟเวอร์สาธารณะได้
โพลล์
คุณสามารถใช้ API เพื่อสร้างโพลล์เกี่ยวกับวิดีโอที่เผยแพร่และรับผลลัพธ์ได้
โฆษณา
คุณสามารถนำวิดีโอที่เผยแพร่แล้วมาใช้ร่วมกับตำแหน่งข้อมูลชิ้นงานโฆษณาของ API การตลาด เพื่อสร้างโฆษณาแบบวิดีโอได้
ข้อมูลเชิงลึก
คุณสามารถรับข้อมูลเชิงลึกเกี่ยวกับวิดีโอใดๆ ที่เผยแพร่แล้วได้ ทั้งนี้ คุณสามารถส่งกลับข้อมูลเชิงลึกสำหรับวิดีโอที่โพสต์ข้ามเพจโดยเป็นค่ารวมหรือแบ่งตามเพจก็ได้
Webhooks
สำหรับวิดีโอที่เผยแพร่บนเพจ คุณสามารถรับการแจ้งเตือนแบบเรียลไทม์ให้ทราบถึงการเปลี่ยนแปลงสถานะการเผยแพร่ของวิดีโอและการโต้ตอบของผู้ชมได้โดยการตั้งค่า Webhooks ของเพจ ตั้งค่าการเรียกกลับ แล้วสมัครรับข้อมูลฟิลด์ feed และ videos ของหัวข้อของเพจ เพื่อรับการแจ้งเตือน โปรดทราบว่าระบบจะไม่ส่งการแจ้งเตือนสำหรับวิดีโอที่อัพโหลดเป็นแบบ secret หรือ no_story
การจัดการสิทธิ์
สำหรับวิดีโอที่เผยแพร่บนเพจ คุณสามารถใช้ API การจัดการสิทธิ์เพื่อสร้างและใช้กฎการปกป้องลิขสิทธิ์เพื่อค้นหาวิดีโอที่เผยแพร่แล้วอื่นๆ ที่อาจมีการละเมิด และรายงานวิดีโอเหล่านั้นได้
ข้อกำหนด
สิทธิ์การอนุญาต
หากต้องการเผยแพร่บนเพจ ผู้ใช้แอพจะต้องมอบสิทธิ์การอนุญาต pages_show_list, pages_read_engagement และ pages_manage_posts ให้แก่แอพของคุณ
หากต้องการเผยแพร่บนกลุ่ม ผู้ใช้แอพจะต้องมอบสิทธิ์การอนุญาต publish_to_groups ให้แก่แอพของคุณ
คุณสมบัติ
ไม่จำเป็นต้องใช้คุณสมบัติใดๆ เพื่อเผยแพร่บนเพจ หากต้องการเผยแพร่บนกลุ่ม แอพของคุณต้องได้รับการอนุมติสำหรับคุณสมบัติ API กลุ่ม
บทบาทผู้ดูแล
ผู้ใช้แอพจะต้องสามารถดำเนินการต่างๆ ที่เทียบเท่ากับงาน ADMIN บนเพจเป้าหมายได้ หรือเป็นผู้ดูแลของกลุ่มเป้าหมาย
การตรวจสอบแอพ
สิทธิ์การอนุญาตและคุณสมบัติทั้งหมดต้องผ่านการตรวจสอบแอพ
ลักษณะการทำงาน
ขั้นตอนทั่วไปสำหรับการเผยแพร่วิดีโอบนเพจหรือกลุ่มมีดังนี้:
- รับโทเค็นการเข้าถึงและสิทธิ์การอนุญาตที่เหมาะสมจากผู้ใช้แอพของคุณ
- รับรายการเพจหรือกลุ่มที่ผู้ใช้แอพสามารถทำงานที่เทียบเท่าผู้ดูแลได้
- แสดงวิธีเพื่อให้ผู้ใช้แอพเลือกเพจหรือกลุ่มที่ต้องการให้วิดีโอปรากฏ
- แสดงวิธีเพื่อให้ผู้ใช้แอพเลือกวิดีโอที่จะเผยแพร่
- แบ่งวิดีโอเป็นกลุ่มข้อมูลที่มีขนาดเล็กลง
- เริ่มเซสชั่นการอัพโหลดและอัพโหลดกลุ่มข้อมูลแต่ละไฟล์
- สิ้นสุดเซสชั่นการอัพโหลด