اكتشاف حالة حقوق النشر

يعرض هذا الدليل كيفية اكتشاف انتهاكات حقوق النشر للفيديو الذي تم تحميله أو نشره في Instagram باستخدام واجهة Instagram Graph API.

ندعم فقط الوسائط الموجودة على Instagram والتي تم إنشاؤها عبر API نشر المحتوى للكشف المبكر عن انتهاكات حقوق النشر.

قبل البدء

قبل البدء ستحتاج إلى ما يلي:

• تنطبق كل متطلبات وتقييدات الوصول إلى نقاط نهاية حاوية Instagram ووسائط Instagram

أفضل الممارسات

التحقق من الفيديو الذي تم تحميله

للتحقق من حالة حقوق النشر لفيديو تم تحميله، ولكن لم يتم نشره، أرسل طلب GET إلى نقطة النهاية /{ig-containter-id} مع تعيين المعلمة fields على copyright_check_status.

عينة من الطلب

curl -i -X GET "https://graph.facebook.com/v21.0/{ig-containter-id}?fields=copyright_check_status"
    

عند نجاح العملية، يتلقى التطبيق استجابة JSON تتضمن الكائن copyright_check_status والذي يحتوي على أزواج القيم والمفاتيح التالية:

• تعيين status على completed أو error أو in_progress أو not_started
• تعيين matches_found على:

  • false إذا لم يتم اكتشاف انتهاكات
  • true إذا تم اكتشاف الانتهاكات والقيم author وcontent_title وmatched_segments وowner_copyright_policy

عينة من الاستجابات

{
  "copyright_check_status": {
    "status": "complete",
    "matches_found": true
  },
  "id": "{ig-containter-id}"
}

{
  "copyright_check_status": {
      "status": "in_progress",
      "matches_found": false
  }
}

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

للتحقق من حالة حقوق النشر لفيديو منشور، أرسل طلب GET إلى نقطة النهاية /{ig-media-id} مع تعيين المعلمة fields على copyright_check_information.

عينة من الطلب

curl -i -X GET "https://graph.facebook.com/v21.0/{ig-media-id}?fields=copyright_check_information"
    

عند نجاح العملية، يتلقى التطبيق استجابة JSON مع تعيين id على الفيديو الذي يتم التحقق منه والكائن copyright_check_information وتتضمن ما يلي:

• تعيين status على كائن status تم تعيينه على completed أو error أو in_progress أو not_started
• تعيين copyright_matches على:

  • false - يتم الإرجاع عند عدم اكتشاف أي انتهاكات لحقوق النشر
  • true - يتم الإرجاع عند اكتشاف انتهاكات لحقوق النشر ويتضمن الكائن copyright_check_information الذي يحتوي على معلومات حول مالك حقوق النشر والسياسة وخطوات المعالجة وأقسام الوسائط التي انتهكت حقوق النشر.

عينة من الاستجابات

{
  "copyright_check_information": {
     "status": {
       "status": "complete",
       "matches_found": true
     },
     "copyright_matches": [
       {
         "content_title": "In My Feelings",
         "author": "Drake",
         "owner_copyright_policy": {
           "name": "UMG",
           "actions": [
             {
               "action": "BLOCK",
               "territories": "3",
               "geos": [
                 "Canada",
                 "India",
                 "United States of America"
               ]
             },
             {
               "action": "MUTE",
               "territories": "4",
               "geos": [
                 "Taiwan",
                 "Tanzania",
                 "Saudi Arabia",
                 "United Kingdom of Great Britain and Northern Ireland"
               ]
             }
           ]
         },
         "matched_segments": [
          {
            "start_time_in_seconds": 2.4,
            "duration_in_seconds": 5.1,
            "segment_type": "AUDIO"
          },
          {
            "start_time_in_seconds": 10.2,
            "duration_in_seconds": 4.5,
            "segment_type": "VIDEO"
          }
        ]
      }
    ]
  },
  "id": "90012800291314"
}

{
  "copyright_check_information": {
    "status": {
      "status": "complete",
      "matches_found": false
    }
  },
  "id": "{ig-media-id}"
}

راجع أيضًا

• مرجع حاوية Instagram
• مرجع وسائط Instagram