Ringkasan untuk Video API dari Meta

Video API adalah kumpulan endpoint Graph API yang memungkinkan aplikasi untuk menerbitkan video yang ada di Halaman yang dikelola pengguna aplikasi.

Komponen

URL Host

Semua permintaan diteruskan ke URL penyelenggara graph.facebook.com.

Protokol Unggah

Unggah video menggunakan API Unggah yang Dapat Dilanjutkan.

Sumber

API menggunakan node berikut:

Video

Node Video adalah sumber utama API. Saat Anda mengunggah video yang sudah ada, API menghasilkan entitas Video dan menerbitkannya di Halaman. Video harus diterbitkan pada node target.

Halaman

Video dapat diterbitkan di Halaman selama pengguna aplikasi dapat melakukan Tugas setara admin di Halaman tersebut, atau telah diberi Peran Admin di Halaman tersebut melalui Pengelola Bisnis.

Video Crossposting

Video yang sudah diterbitkan juga bisa diterbitkan di Halaman lain yang dikelola pengguna aplikasi tanpa harus diunggah ulang. Insight Video Crossposting dapat dikembalikan sebagai nilai gabungan (mis., jumlah dari semua penayangan di semua Halaman) atau dipecah berdasarkan Halaman.

Tayangan Slide

API ini dapat digunakan untuk membuat Video tayangan slide dari set gambar yang di-hosting di server publik.

Polling

Anda dapat menggunakan API untuk membuat Polling pada video yang diterbitkan dan mendapatkan hasilnya.

Iklan

Video yang Diterbitkan dapat digunakan dengan endpoint Materi Iklan Marketing API untuk membuat Iklan Video.

Insight

Anda bisa mendapatkan insight atas Video yang diterbitkan. Insight Video Crossposting dapat dikembalikan sebagai nilai gabungan atau dipecah berdasarkan Halaman.

Webhooks

Anda dapat menerima notifikasi realtime tentang perubahan status penerbitan Video dan interaksi pemirsa dengan menyiapkan Webhooks Halaman. Siapkan panggilan balik, lalu berlangganan ke kolom feed dan videos dari topik Halaman untuk menerima notifikasi. Perhatikan bahwa notifikasi tidak akan dikirim untuk video yang diunggah sebagai secret atau no_story.

Pengelolaan Hak

Untuk Video yang diterbitkan di Halaman, Anda dapat menggunakan API Pengelola Hak untuk membuat dan menerapkan aturan hak cipta agar menemukan Video yang diterbitkan lainnya yang mungkin melanggar, dan melaporkannya.

Persyaratan

Izin

Untuk menerbitkan di Halaman, pengguna aplikasi harus memberi aplikasi Anda Izin pages_show_list, pages_read_engagement, dan pages_manage_posts.

Peran Admin

Pengguna aplikasi harus dapat melakukan yang setara dengan tugas ADMIN di Halaman target.

Tinjauan Aplikasi

Semua izin memerlukan Tinjauan Aplikasi.

Cara Kerjanya

Alur umum menerbitkan video di Halaman:

1. Dapatkan Token Akses dan izin yang sesuai dari pengguna aplikasi Anda
2. Dapatkan daftar Halaman tempat pengguna aplikasi dapat melakukan Tugas yang setara dengan admin
3. Sediakan cara bagi pengguna aplikasi untuk memilih Halaman tempat mereka ingin Video tersebut muncul
4. Sediakan cara bagi pengguna aplikasi untuk memilih Video yang akan diterbitkan.
5. Unggah video menggunakan API Unggah yang Dapat Dilanjutkan
6. Terbitkan video ke Halaman menggunakan ID Video