‏منصة Instagram‏

التعليق في IG

يمثل تعليقًا على وسائط IG.

الإنشاء

هذه العملية غير مدعومة.

القراءة

GET /{ig-comment-id}?fields={fields}

احصل على الحقول وعناصر الربط في تعليق IG.

التقييدات

  • لا يمكن تنفيذ الطلبات على التعليقات التي تم اكتشافها من خلال واجهة API عمليات الذِكر إلا إذا تم تقديم الطلب من جانب مالك التعليق. وبدلًا من ذلك، استخدم العقدة التعليق المذكور.
  • لا يتم إرجاع التعليقات على الوسائط المُقيدة بفئة عمرية محددة.
  • لن يتم إرجاع التعليقات التي تم إنشاؤها بواسطة مستخدمي IG الذين تم تقييدهم من قِبل مستخدم التطبيق ما لم يتم إلغاء تقييد مستخدمي IG واعتماد التعليقات.
  • يمكن قراءة التعليقات على وسائط IG لفيديو البث المباشر فقط أثناء بث وسائط IG التي تم إنشاء التعليق عليها.

المتطلبات

النوعالمتطلب

رموز الوصول

المستخدم

الأذونات

instagram_basic
pages_read_engagement
pages_show_list


إذا تم منح مستخدم التطبيق دورًا في الصفحة المرتبطة بمستخدم IG المستهدف عبر مدير الأعمال، فستحتاج أيضًا إلى أي مما يلي:


ads_management
business_management

بنية الطلب

GET https://graph.facebook.com/{api-version}/{ig-comment-id}
  ?fields={fields}
  &access_token={access-token}

معلمات المسار

العنصر النائبالقيمة

{api-version}

يمثل إصدار API.

{ig-comment-id}

مطلوب. يمثل معرف تعليق IG.

معلمات سلسلة الاستعلام

المفتاحالعنصر النائبالقيمة

access_token

{access-token}

مطلوب. رمز وصول المستخدم لمستخدم التطبيق.

fields

{fields}

قائمة مفصولة بفاصلة تتضمن حقول تعليق IG التي تريد إرجاعها لكل تعليق IG في مجموعة النتائج.

الحقول

اسم الحقلالوصف

from

كائن يحتوي على:


  • id — IGSID لمستخدم Instagram الذي أنشأ تعليق IG.
  • username — اسم مستخدم Instagram الذي أنشأ تعليق IG.

hidden

يشير إلى ما إذا تم إخفاء التعليق (true) أم لا (false).

id

يمثل معرف تعليق IG.

like_count

يمثل عدد تسجيلات الإعجاب على تعليق IG.

media

كائن يحتوي على:


  • id — معرف وسائط IG الذي تم وضع تعليق IG عليها.
  • media_product_type — مكان نشر وسائط IG (أي، حيث تظهر وسائط IG) التي تم وضع تعليق IG عليها.

parent_id

يمثل معرف تعليق IG الأصل إذا تم إنشاء هذا التعليق على تعليق IG آخر (مثل رد على تعليق آخر.

replies

يمثل قائمة ردود (تعليقات IG) التي تم إنشاؤها على تعليق IG.

text

يمثل نص تعليق IG.

timestamp

يمثل طابعًا زمنيًا بتنسيق ISO 8601 يشير إلى وقت إنشاء تعليق IG.


مثال: 2017-05-19T23:27:28+0000.

user

يمثل معرف مستخدم IG الذي أنشأ تعليق IG. ولا يتم إرجاعه إلا إذا أنشأ مستخدم التطبيق تعليق IG، وإلا فسيتم إرجاع الحقل username بدلاً من ذلك.

username

يمثل اسم مستخدم Instagram الذي أنشأ تعليق IG.

عناصر الربط

عنصر الربطالوصف

replies

احصل على قائمة بتعليقات IG التي تم إنشاؤها على تعليق IG؛ أنشئ تعليق IG على تعليق IG.

الاستجابة

كائن بتنسيق لغة JSON يتضمن الحقول وعناصر الربط الافتراضية والمطلوبة.

{
  "{field}":"{value}",
  ...
}

مثال على cURL

الطلب

curl -i -X GET \
 "https://graph.facebook.com/v19.0/17881770991003328?fields=hidden%2Cmedia%2Ctimestamp&access_token=EAAOc..."

الاستجابة

{
  "hidden": false,
  "media": {
    "id": "17856134461174448"
  },
  "timestamp": "2017-05-19T23:27:28+0000",
  "id": "17881770991003328"
}

التحديث

إخفاء/إظهار تعليق

POST /{ig-comment-id}?hide={hide}

معلمات سلسلة الاستعلام

  • {hide} (مطلوب) — يمكن التعيين إلى القيمة true لإخفاء التعليق، أو التعيين إلى القيمة false لإظهار التعليق.

التقييدات

  • سيتم دومًا عرض التعليقات التي تم إنشاؤها من جانب مالكي كائن الوسائط في كائنات الوسائط لديك، حتى في حالة تعيين التعليقات إلى القيمة hide=true.
  • التعليقات على وسائط IG لفيديو البث المباشر غير مدعومة.

الأذونات

يمثل رمز وصول المستخدم المتوفر من مستخدم Facebook الذي أنشأ التعليق باستخدام الأذونات التالية:

  • instagram_basic
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement

إذا تم الحصول على الرمز من مستخدم تم منحه دورًا بالصفحة عبر مدير الأعمال، فيلزم أيضًا توفير أحد الأذونات التالية:

  • ads_management
  • pages_read_engagement
  • business_management

عينة من الطلب

إخفاء تعليق:

POST graph.facebook.com
  /17873440459141021?hide=true

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

{
  "success": true
}

الحذف

حذف تعليق

DELETE /{ig-comment-id}

الأذونات

يمثل رمز وصول المستخدم المتوفر من المستخدم الذي أنشأ التعليق باستخدام الأذونات التالية:

  • instagram_basic
  • instagram_manage_comments

إذا تم الحصول على الرمز من مستخدم تم منحه دورًا بالصفحة عبر مدير الأعمال، فيلزم أيضًا توفير أحد الأذونات التالية:

  • ads_management
  • pages_read_engagement
  • business_management

التقييدات

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

عينة من الطلب

DELETE graph.facebook.com
  /17873440459141021

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

{
  "success": true
}