‏منصة Instagram‏

التعليق في Instagram (IG)

يمثل تعليقًا على كائن وسائط Instagram.

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

نقدم الحقول التالية:

  • legacy_instagram_comment_id

الحقول التالية غير مدعومة:

  • comment_type
  • mentioned_instagram_users

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • ads_read

الإنشاء

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

القراءة

GET <HOST_URL>/<IG_COMMENT_ID>?fields=<LIST_OF_FIELDS>

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

التقييدات

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

بنية الطلب

GET https://<HOST_URL>/<API_VERSION>/<IG_COMMENT_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

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

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

<API_VERSION>

إصدار API.

<HOST_URL>

إصدار API.

<IG_COMMENT_ID>

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

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

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

access_token

<ACCESS_TOKEN>

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

fields

<LIST_OF_FIELDS>

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

الحقول

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

from

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

hidden

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

id

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

like_count

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

legacy_instagram_comment_id

معرف تعليق Instagram الذي تم إنشاؤه لنقاط نهاية API التسويق بالإصدار 21.0 والإصدارات الأقدم.

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.

بدءًا من 27 أغسطس 2024، سيكون الإذن instagram_manage_comments (إذا استخدم التطبيق تسجيل دخول فيسبوك) والإذن instagram_business_manage_comments (إذا استخدم التطبيق تسجيل دخول Instagram) مطلوبان للوصول إلى الحقل username لمستخدم Instagram الذي علق على وسائط الحساب الاحترافي في Instagram لمستخدم تطبيق.

عناصر الربط

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

replies

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

الاستجابة

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

{
  "<FIELD>":"<VALUE>",
  ...
}

مثال على cURL

الطلب

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

الاستجابة

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

التحديث

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

POST <HOST_URL>/<IG_COMMENT_ID>?hide=<BOOLEAN>

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

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

التقييدات

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

رمز الوصول

رمز وصول المستخدم من جانب المستخدم الذي يملك كائن الوسائط الذي تم التعليق عليه.

مثال على الطلب

إخفاء تعليق:

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

مثال على الاستجابة

{
  "success": true
}

الحذف

حذف تعليق

DELETE <HOST_URL>/<IG_COMMENT_ID>

رمز الوصول

رمز وصول المستخدم الذي يتم الحصول عليه من المستخدم الذي أنشأ التعليق.

التقييدات

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

مثال على الطلب

DELETE graph.instagram.com
  /17873440459141021

مثال على الاستجابة

{
  "success": true
}