Tổng quan về API Video từ Meta

API Video là tập hợp các điểm cuối API Đồ thị cho phép ứng dụng đăng video có sẵn lên Trang do người dùng ứng dụng quản lý.

Thành phần

URL lưu trữ

Mọi yêu cầu đều được chuyển cho URL lưu trữ graph.facebook.com.

Giao thức tải lên

Tải video lên bằng API Tải lên nối tiếp.

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 ra một thực thể Video và đăng lên Trang. Bạn phải đăng video trên nút mục tiêu.

Trang

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 thì mới có thể đăng video lên Trang.

Video đăng chéo

Những video đã đăng trước đó cũng có thể được đăng lên các Trang khác do người dùng ứng dụng quản lý mà 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 mọi 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ừ bộ sưu tậ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à nhận 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

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ư hoạt động 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 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 được 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 Công cụ bảo vệ bản quyền để tạo và áp dụng quy tắc bản quyền nhằm phát hiện các Video khác đã đăng 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ủa bạn các quyền pages_show_list, pages_read_engagement và pages_manage_posts.

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ụ tương đương với tác vụ ADMIN trên Trang được nhắm mục tiêu.

Xét duyệt ứng dụng

Mọi quyền đều phải trải qua quy trình Xét duyệt ứng dụng.

Cách hoạt động

Quy trình chung để đăng video lên Trang:

1. Lấy Mã truy cập và quyền thích hợp từ người dùng ứng dụng
2. Lấy danh sách Trang mà người dùng ứng dụng có thể thực hiện Tác vụ tương đương với quản trị viên
3. Cung cấp cho người dùng ứng dụng phương thức chọn Trang mà họ muốn video xuất hiện
4. Cung cấp cho người dùng ứng dụng phương thức chọn Video sẽ đăng.
5. Tải video lên bằng API Tải lên nối tiếp
6. Đăng video lên Trang bằng ID Video