Komponen
URL Host
https://graph-video.facebook.com— Digunakan secara eksklusif untuk menerbitkan video di Halaman dan Grup.https://graph.facebook.com— Digunakan untuk hal lainnya (membuat polling, mendapatkan insight, dll.).
Protokol Unggah
API mendukung protokol Unggah yang Dapat Dilanjutkan dan Unggah yang Tidak Dapat Dilanjutkan. Protokol Unggah yang Dapat Dilanjutkan digunakan untuk mengunggah potongan video secara berurutan sedangkan Protokol Unggah yang Tidak Dapat Dilanjutkan digunakan untuk mengunggah video lengkap. Kami rekomendasikan untuk menggunakan protokol Unggah yang Dapat Dilanjutkan karena mendukung file video yang lebih besar dan memungkinkan Anda menangani gangguan koneksi dengan lebih efisien.
Sumber Informasi
API menggunakan node berikut:
Video
Node Video adalah sumber utama API. Saat Anda mengunggah video yang ada, API menghasilkan entitas Video dan menerbitkannya di Halaman atau Grup, bergantung pada node yang Anda targetkan saat Anda memulai proses penerbitan. Video harus diterbitkan pada node target.
Halaman
Video dapat diterbitkan di Grup selama aplikasi memiliki Izin dan Fitur yang sesuai. Selain itu, pengguna aplikasi harus dapat melakukan Tugas yang setara dengan admin di Halaman, atau telah diberikan Peran Admin di Halaman melalui Pengelola Bisnis.
Grup
Video dapat diterbitkan di Grup selama aplikasi memiliki Izin dan Fitur yang sesuai dan pengguna aplikasi adalah Admin Grup.
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
API dapat digunakan untuk membuat Polling atas video yang diterbitkan dan mendapatkan hasil polling.
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
Untuk Video yang diterbitkan di Halaman, Anda dapat menerima notifikasi realtime tentang perubahan status penerbitan Video dan interaksi pemirsa dengan menyiapkan Webhook Halaman. Siapkan callback, 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 Pengelolaan 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.
Untuk menerbitkan di Grup, pengguna aplikasi harus memberi aplikasi Anda Izin publish_to_groups.
Fitur
Tidak perlu Fitur untuk menerbitkan di Halaman. Untuk menerbitkan di Grup, aplikasi Anda harus disetujui untuk Fitur API Grup.
Peran Admin
Pengguna aplikasi harus dapat melakukan yang setara dengan tugas ADMIN di Halaman target, atau menjadi Admin dari Grup target.
Tinjauan Aplikasi
Semua Izin dan Fitur memerlukan Tinjauan Aplikasi.
Cara Kerjanya
Alur umum menerbitkan Video di Halaman atau Grup:
- Dapatkan Token Akses dan Izin yang sesuai dari pengguna aplikasi Anda.
- Dapatkan daftar Halaman atau Grup tempat pengguna aplikasi dapat melakukan Tugas yang setara dengan admin.
- Sediakan cara bagi pengguna aplikasi untuk memilih Halaman atau Grup tempat mereka ingin Video tersebut muncul.
- Sediakan cara bagi pengguna aplikasi untuk memilih Video yang akan diterbitkan.
- Bagi Video menjadi beberapa bagian yang lebih kecil.
- Mulailah sesi unggah dan unggah potongan individu.
- Akhiri sesi unggah.