Thành phần
URL lưu trữ
https://graph-video.facebook.com– Chỉ dùng để đăng video lên Trang và Nhóm.https://graph.facebook.com– Dùng cho mọi hoạt động khác (tạo cuộc thăm dò ý kiến, lấy thông tin chi tiết, v.v.).
Giao thức tải lên
API này hỗ trợ cả giao thức Tải lên nối tiếp và Tải lên không nối tiếp. Giao thức Tải lên nối tiếp được dùng để tải lên các file cắt ra từ video theo trình tự, còn giao thức Tải lên không nối tiếp dùng để tải lên các video hoàn chỉnh. Bạn nên sử dụng giao thức Tải lên nối tiếp vì giao thức này hỗ trợ các file video lớn hơn, nhờ đó mà bạn có thể xử lý tình trạng gián đoạn kết nối một cách hiệu quả hơn.
Tài nguyên
API này sử dụng các nút sau đây.
Video
Nút Video là tài nguyên chính của API này. Khi bạn tải video có sẵn lên, API này sẽ tạo một thực thể Video và đăng lên Trang hoặc Nhóm, tùy vào nút mà bạn nhắm mục tiêu khi bắt đầu quy trình đăng. Bạn phải đăng video trên nút mục tiêu.
Trang
Video có thể được đăng lên Nhóm miễn là ứng dụng có Quyền và Tính năng thích hợp. Ngoài ra, người dùng ứng dụng phải có khả năng thực hiện Tác vụ tương đương với quản trị viên trên Trang hoặc đã được cấp Vai trò quản trị viên trên Trang thông qua Trình quản lý kinh doanh.
Nhóm
Video có thể được đăng lên Nhóm miễn là ứng dụng có Quyền và Tính năng thích hợp, đồng thời người dùng ứng dụng là Quản trị viên của Nhóm.
Video đăng chéo
Những video đã đăng trước đó cũng có thể được đăng lên các Trang khác mà người dùng ứng dụng quản lý (không cần phải tải lên lại). Hệ thống có thể trả về thông tin chi tiết về Video đăng chéo dưới dạng giá trị tổng hợp (ví dụ: tổng toàn bộ lượt xem trên tất cả các Trang) hoặc chia nhỏ theo Trang.
Bản trình chiếu
Bạn có thể dùng API này để tạo Video bản trình chiếu từ tập hợp hình ảnh được lưu trữ trên máy chủ công khai.
Cuộc thăm dò ý kiến
Bạn có thể dùng API này để tạo Cuộc thăm dò ý kiến về video đã đăng và lấy kết quả.
Quảng cáo
Bạn có thể dùng Video đã đăng với điểm cuối Nội dung quảng cáo của API Marketing để tạo Quảng cáo video.
Thông tin chi tiết
Bạn có thể lấy thông tin chi tiết về mọi Video đã đăng. Hệ thống có thể trả về thông tin chi tiết về Video đăng chéo dưới dạng giá trị tổng hợp hoặc chia nhỏ theo Trang.
Webhooks
Đối với Video đã đăng lên Trang, bạn có thể nhận được thông báo tức thì về các thay đổi đối với trạng thái đăng của Video, cũng như lượt tương tác của người xem bằng cách thiết lập Webhooks của Trang. Hãy thiết lập lệnh gọi lại rồi đăng ký các trường thông tin feed và videos của chủ đề Trang để nhận được thông báo. Lưu ý rằng hệ thống sẽ không gửi thông báo cho các video tải lên dưới dạng secret hoặc no_story.
Quản lý quyền
Đối với Video đã đăng lên Trang, bạn có thể dùng API Quản lý quyền để tạo và áp dụng các quy tắc bản quyền nhằm phát hiện các Video đã đăng khác có khả năng vi phạm rồi báo cáo những video đó.
Yêu cầu
Quyền
Để đăng lên Trang, người dùng ứng dụng phải cấp cho ứng dụng các Quyền pages_show_list, pages_read_engagement và pages_manage_posts.
Để đăng lên Nhóm, người dùng ứng dụng phải cấp cho ứng dụng Quyền publish_to_groups.
Tính năng
Không cần có Tính năng nào để đăng lên Trang. Để đăng lên Nhóm, ứng dụng của bạn phải được phê duyệt tính năng của API Nhóm.
Vai trò quản trị viên
Người dùng ứng dụng phải có khả năng thực hiện tác vụ ADMIN tương đương trên Trang được nhắm mục tiêu hoặc phải là Quản trị viên của Nhóm được nhắm mục tiêu.
Xét duyệt ứng dụng
Tất cả các Quyền và Tính năng đều phải Xét duyệt ứng dụng.
Cách hoạt động
Sau đây là quy trình chung để đăng Video lên Trang hoặc Nhóm:
- Lấy Mã truy cập và Quyền thích hợp từ người dùng ứng dụng.
- Lấy danh sách các Trang hoặc Nhóm mà người dùng ứng dụng có thể thực hiện các Tác vụ tương đương với quản trị viên.
- Cung cấp cho người dùng ứng dụng phương thức chọn Trang hoặc Nhóm mà họ muốn Video xuất hiện.
- Cung cấp cho người dùng ứng dụng phương thức chọn Video sẽ đăng.
- Tách Video thành các file cắt nhỏ hơn.
- Khởi tạo phiên tải lên rồi tải từng file cắt lên.
- Kết thúc phiên tải lên.