‏واجهة API الفيديو‏

واجهة API مدير حقوق النشر

تمكن واجهة API مدير حقوق النشر الناشرين من طلب ملكية حقوق النشر الخاصة بمقاطع الفيديو وإدارة قواعد مطابقة حقوق النشر من خلال نقطتي نهاية جديدتين: نقطة النهاية video_copyright_rule ونقطة النهاية video_copyright.

الأذونات

لاستخدام واجهة API هذه، ستحتاج إلى التقدم بطلب للوصول إلى أداة مدير حقوق النشر (يجب تسجيل دخولك إلى فيسبوك لاستخدام هذه الأداة). يمكنك قراءة المزيد والتعرف على مدير حقوق النشر في rightsmanager.fb.com.

فيديو حقوق النشر

لا يمكن تطبيق واجهة API مدير حقوق النشر إلا على مقاطع الفيديو في الصفحات. يجب أن تخضع كل الصفحات لاجتياز عملية التسجيل لكي تتأهل لاستخدام واجهة API.
قبل أن تتمكّن من إضافة حقوق النشر لأحد مقاطع الفيديو، يجب عليك إنشاء محتوى فيديو على صفحة فيسبوك. يمكن القيام بذلك باستخدام واجهة API تحميل الفيديو أو واجهة API فيديو البث المباشر.

بالنسبة إلى مقاطع الفيديو، تكون الخطوات كالتالي:

  1. قم بتحميل فيديو إلى فيسبوك والحصول على معرف للفيديو.
  2. استخدم واجهة Rights Manager API لإضافة حقوق النشر للفيديو.

بالنسبة إلى مقاطع فيديو البث المباشر، تكون الخطوات كالتالي:

  1. قم بإنشاء كائن live_video والحصول على معرف فيديو بث مباشر.
  2. استخدم واجهة Rights Manager API لإضافة حقوق النشر لفيديو البث المباشر.
  3. ابدأ بث الفيديو باستخدام برنامج البث لديك.

مرجع فقط

إذا كان لا يتعين استخدام الفيديو إلا كفيديو مرجع، وليس للاستخدام والتوزيع على فيسبوك، يجب تحميل الفيديو باستخدام المعلمة 'reference_only' ويجب استدعاء واجهة API مدير حقوق النشر باستخدام المعلمة is_reference_video. في حالة إجراء البث المباشر، قم فقط بالتأكد من استدعاء مدير حقوق النشر باستخدام 'is_reference_video' قبل بدء البث. لن يظهر الفيديو أو فيديو البث المباشر في مكتبة الفيديو لديك، وسيظهر للمسؤول فقط، في قسم الملفات المرجعية في أداة مدير حقوق النشر.

فهم نقطتي النهاية video_copyright_rule وvideo_copyright

  • نقطة النهاية video_copyright_rule: تتيح لك نقطة النهاية هذه إمكانية إنشاء قاعدة حقوق نشر. على سبيل المثال، يمكنك تحديد نوع الشروط التي يجب تشغيل تقرير انتهاك حقوق النشر بها ونوع الإجراء الذي يجب اتخاذه.

  • نقطة النهاية video_copyright: يمكنك استخدام نقطة النهاية هذه لإضافة حقوق النشر لمقطع فيديو. يمكنك أيضًا تحديد ملكية حقوق النشر وتطبيق قاعدة حقوق نشر هنا.

نقطة النهاية video_copyright_rule

تتيح نقطة النهاية video_copyright_rule لك إنشاء قواعد حقوق النشر التي تحدد الإجراءات التي يجب اتخاذها مع مقطع فيديو يتطابق مع هذه القواعد. على سبيل المثال، يمكنك كمالك لحقوق النشر إنشاء قاعدة حقوق نشر تسمح باستخدام مقطع الفيديو الذي تقدمه لأقل من 3 دقائق.

توجد عدة أنواع للشروط:

  • GEO: لتحديد ما إذا كان الفيديو متوفرًا في موقع بعينه. على سبيل المثال، إذا كان هناك مقطع فيديو مسموح بعرضه في المملكة المتحدة وكان شرط geo هو 'UK and US'، فإن الفيديو يُعتبر مستوفيًا للشرط.
  • OVERLAP_DURATION: يحدد المدة الزمنية المسموح بها لحدوث التطابق (أكثر من أو أقل من 2 أو 3 دقائق على سبيل المثال)
  • MATCH_OVERLAP_PERCENTAGE: يحدد النسبة المئوية لتطابق مقطع الفيديو المطابق (أكبر من أو أقل من 20% من الفيديو المطابق على سبيل المثال)
  • REFERENCE_OVERLAP_PERCENTAGE: يحدد نسبة تطابق الملف المرجعي (أكبر من أو أقل من 50% على سبيل المثال)
  • MONITORING_TYPE: يحدد ما إذا كان الفيديو أو الصوت أو كلاهما مطابقًا
  • PUBLISHER_TYPE: يحدد ما إذا كان الفيديو المطابق مملوكًا لصفحة أو ملف شخصي، أو أحدهما.
  • PRIVACY: يحدد ما إذا كان الفيديو المطابق معروضًا للجمهور العام أو غير العام، أو أحدهما. مقاطع الفيديو غير المتوفرة للجمهور العام يكون لها جمهور محدود. على سبيل المثال، يُعتبر الفيديو المسموح بعرضه على أصدقاء الشخص أو في مجموعة ليس عامًا.

يتوفر أربعة أنواع من الإجراءات:

  • TRACK: يتيح لك هذا الإجراء إمكانية تتبع الفيديو المطابق، دون اتخاذ أي إجراء بشأنه. في المستقبل، ستتمكن أيضًا من عرض الرؤى عن الفيديو المطابق.
  • MONETIZE: يتيح لك هذا الإجراء الاستفادة بحصة من الإيراد الإعلاني الذي يحققه الفيديو. يتطلب ذلك الإجراء ضرورة إعداد عمليات الدفع، وهو ما يمكنك القيام به من خلال قسم Rights Manager في إعدادات الصفحة.
  • BLOCK: يؤدي حظر الفيديو إلى عدم عرضه في أي مناطق جغرافية تملكه فيها.
  • MANUAL_REVIEW: يؤدي هذا الإجراء إلى إرسال التطابق إلى قسم المراجعة اليدوية في Rights Manager، بحيث يمكنك تطبيق إجراء يدويًا على الفيديو المطابق. تنتهي حالات التطابق الموجودة في قسم المراجعة اليدوية لديك في مدة 30 يومًا.

إنشاء قاعدة حقوق نشر

يمكنك إنشاء قاعدة حقوق نشر من خلال إجراء طلب POST إلى عنصر الربط video_copyright_rules في المسار التالي: 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"]}]}]'

قراءة قاعدة حقوق نشر

يمكنك إصدار GET /video_copyright_rule_id request للحصول على مزيد من المعلومات حول قاعدة حقوق النشر.

** لاحظ أنه في هذا المثال، يمثل 576407315867188 معرف قاعدة حقوق النشر.

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

حذف قاعدة حقوق نشر

يمكنك حذف فيديو بث مباشر من خلال إجراء طلب DELETE /video_copyright_rule_id.

نقطة النهاية video_copyright

تتيح لك النقطة نهاية video_copyright تحديد الفيديو الذي تريد إضافة حقوق نشر إليه. من نقطة النهاية هذه، يمكنك إضافة مستخدمين آخرين أو صفحات أخرى إلى القائمة البيضاء ليتمكنوا من استخدام الفيديو المرجعي. على سبيل المثال، إذا كانت لديك 3 صفحات وتريد إضافة حقوق النشر لفيديو محدد للسماح بتشغيله على جميع هذه الصفحات، فيمكنك تحديد تلك الصفحات في القائمة البيضاء.

إنشاء نقطة نهاية video_copyright

يمكنك إجراء طلب POST إلى عنصر الربط video_copyrights من المسارات التالية: ‏/{page_id}/video_copyrights

** لاحظ أنه في هذا المثال يمثل 576425449198708 معرف الفيديو الذي يشير إلى أن الفيديو سيخضع لحقوق النشر.

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"}

بالنسبة لأي مقطع فيديو محدد، يمكنك الاستعلام عن الحقل 'copyright' (حقوق النشر) للحصول على مزيد من المعلومات حول العقدة video_copyright.

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

كما تتوفر إمكانات التحديث والقراءة والحذف في نقطة النهاية video_copyright. لمزيد من المعلومات، يرجى الرجوع إلى وثائق نقطة نهاية حقوق نشر الفيديو المرجعية.