Video API

API Rights Manager

API Rights Manager memungkinkan penerbit mengklaim kepemilikan hak cipta untuk video dan mengelola peraturan kecocokan hak cipta dengan dua endpoint baru: endpoint video_copyright_rule dan endpoint video_copyright.

Izin

Untuk menggunakan API ini, Anda akan perlu mengajukan permohonan akses ke alat Rights Manager (Anda harus login ke Facebook untuk menggunakan alat ini). Anda dapat membaca selengkapnya dan mempelajari tentang Rights Manager di rightsmanager.fb.com.

Membuat Hak Cipta Video

API Rights Manager hanya dapat diterapkan pada video di halaman. Semua halaman perlu melalui proses pendaftaran agar memenuhi syarat untuk menggunakan API.
Sebelum dapat membuat hak cipta video, Anda harus membuat konten video di Halaman Facebook. Ini bisa dilakukan melalui API Unggahan Video atau API Siaran Langsung Video.

Untuk Video, langkah-langkahnya adalah:

  1. Unggah video ke Facebook dan dapatkan id video.
  2. Gunakan API Rights Manager untuk membuat hak cipta video.

Untuk Video Siaran Langsung, langkah-langkahnya adalah:

  1. Buat objek live_video dan dapatkan id video siaran langsung.
  2. Gunakan API Rights Manager untuk membuat hak cipta video siaran langsung.
  3. Mulai streaming menggunakan perangkat lunak streaming Anda.

Hanya Referensi

Jika video hanya ingin digunakan sebagai referensi video, dan bukan untuk konsumsi dan distribusi di Facebook, video tersebut harus diunggah menggunakan parameter 'reference_only', dan API Rights Manager perlu dipicu menggunakan parameter is_reference_video. Saat streaming, pastikan Anda menghubungi Rights Manager dengan 'is_reference_video' sebelum mulai melakukan streaming. Video atau video siaran langsung tidak akan muncul di Perpustakaan Video, dan hanya akan terlihat oleh Pengurus di bagian File Referensi alat Rights Manager.

Memahami Endpoint video_copyright_rule dan video_copyright

  • Endpoint video_copyright_rule: Dengan endpoint ini, Anda dapat membuat aturan hak cipta. Misalnya, Anda dapat menentukan berdasarkan kondisi seperti apa laporan hak cipta harus dipicu dan tindakan apa yang harus dilakukan.

  • Endpoint video_copyright: Anda dapat menggunakan endpoint ini untuk membuat hak cipta video tertentu. Anda juga dapat menentukan kepemilikan hak cipta dan menerapkan aturan hak cipta di sini.

Endpoint video_copyright_rule

Dengan video_copyright_rule endpoint, Anda dapat membuat aturan hak cipta yang menentukan tindakan yang akan diambil pada video yang cocok dengan aturan ini. Misalnya, Anda sebagai pemilik hak dapat membuat aturan hak cipta yang mengizinkan penggunaan video kurang dari 3 menit.

Ada beberapa jenis ketentuan:

  • GEO: Tentukan apakah video tersedia di lokasi tertentu. Misalnya, jika video bisa dilihat di Inggris, dan kondisi geografisnya adalah 'Inggris dan AS', maka video tersebut memenuhi syarat.
  • OVERLAP_DURATION: Tentukan berapa lama kecocokan yang terjadi ( misalnya, lebih besar atau kurang dari 2 atau 3 menit)
  • MATCH_OVERLAP_PERCENTAGE: Tentukan berapa persentase pencocokan video yang cocok (misalnya, lebih besar atau kurang dari 20% dari video yang cocok)
  • REFERENCE_OVERLAP_PERCENTAGE: Tentukan berapa persentase file referensi yang cocok (misalnya, lebih besar atau kurang dari 50%)
  • MONITORING_TYPE: Tentukan apakah video, audio, atau keduanya cocok
  • PUBLISHER_TYPE: Baik video yang cocok dimiliki oleh sebuah Halaman, Profil, atau tidak kedua-duanya.
  • PRIVACY: Tentukan apakah video yang cocok itu bersifat publik, non-publik, atau tidak kedua-duanya. Video non-publik memiliki pemirsa terbatas. Misalnya, video yang terlihat oleh teman seseorang atau grup adalah non-publik.

Ada empat jenis tindakan yang tersedia:

  • TRACK: Tindakan ini memungkinkan Anda melacak video yang cocok tanpa mengambil tindakan apa pun di dalamnya. Di masa yang akan datang, Anda akan dapat melihat insight tentang video yang cocok.
  • MONETIZE: Tindakan ini memungkinkan Anda membagikan pendapatan iklan yang dihasilkan video. Tindakan ini mengharuskan Anda menyiapkan Pembayaran yang dapat dilakukan dari bagian Rights Manager Pengaturan Halaman Anda.
  • BLOCK: Memblokir video berarti video tidak akan terlihat di wilayah geografis mana pun tempat Anda memiliki video tersebut
  • MANUAL_REVIEW: Tindakan ini akan mengirim kecocokan ke bagian Tinjauan Manual Rights Manager, sehingga Anda mungkin menerapkan tindakan secara manual pada video yang cocok. Kecocokan di bagian tinjauan manual akan kedaluwarsa dalam 30 hari.

Membuat Aturan Hak Cipta

Anda dapat membuat aturan hak cipta dengan membuat permintaan POST ke edge video_copyright_rules pada jalur berikut: POST/{pageid}/video_copyright_rules.

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyright_rules' \
 -F 'access_token=XXXXXXXX' \
 -F 'name="testrule"' \
 -F 'condition_groups=[{action:"MANUAL_REVIEW",conditions:[{type:"MONITORING_TYPE",operator:"IS",value:"VIDEO_ONLY"},{type:"OVERLAP_DURATION",operator:"LESS_THAN",value:120000},{type:"GEO",operator:"IN_SET",value:["AR","AU"]}]}]'

Membaca Aturan Hak Cipta

Lihat GET /video_copyright_rule_id request untuk mendapatkan informasi selengkapnya tentang aturan hak ciptanya.

** Perhatikan dalam contoh ini bahwa 576407315867188 adalah ID aturan hak cipta.

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?&access_token=XXXXXXXX' \

Menghapus Aturan Hak Cipta

Anda dapat menghapus video siaran langsung dengan membuat permintaan DELETE /video_copyright_rule_id.

Endpoint video_copyright

Endpoint video_copyright memungkinkan Anda menentukan video mana yang ingin Anda buatkan hak cipta. Dari endpoint ini, Anda dapat memasukkan dalam daftar putih halaman atau pengguna lain untuk menggunakan video referensi. Misalnya, jika Anda memiliki 3 halaman dan ingin memberi hak cipta pada video tertentu untuk dapat diputar di semua halaman Anda, Anda dapat menentukan halaman tersebut di daftar putih.

Membuat Endpoint video_copyright

Anda dapat membuat permintaan POST ke edge video_copyrights dari jalur berikut: /{page_id}/video_copyrights

** Perhatikan dalam contoh ini bahwa 576425449198708 adalah ID video yang mewakili video yang akan dibuatkan hak cipta.

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyrights' \
-F  'access_token=XXXXXXXX' \
-F  'copyright_content_id=576425449198708' \
-F  'is_reference_video=true' \
-F  'monitoring_type=VIDEO_ONLY' \
-F  'rule_id=576407315867188' \
-F  'whitelisted_ids=[139577256378818]' \
-F  'ownership_countries=[“us”,”ca”]' \
Return values: Video copyright id.
{"id":"576425925865327"}

Untuk video tertentu, Anda dapat meminta kolom 'hak cipta' untuk mendapatkan informasi selengkapnya tentang node video_copyright.

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?fields=copyright&access_token=XXXXXXXX' \

Kemampuan Mengupdate, Membaca, dan Menghapus juga tersedia untuk endpoint video_copyright. Untuk informasi selengkapnya, lihat ke dokumentasi endpoint hak cipta video.