التنفيذ: التعليقات

لم يعُد استخدام طريقة comments.markAsSpam متاحًا.

توضِّح الأمثلة التالية كيفية استخدام YouTube Data API (الإصدار 3) لتنفيذ وظائف ذات صلة بالتعليقات.

استرداد التعليقات المنشورة على فيديو

لاسترداد قائمة بسلاسل التعليقات حول فيديو معيّن، يمكنك استدعاء الطريقة commentThreads.list. اضبط قيم المَعلمات التالية في طلبك:

• part: اضبط قيمة المَعلمة على snippet إذا كنت تريد استرداد التعليقات من المستوى الأعلى فقط أو على snippet,replies إذا كنت تريد أيضًا استرداد الردود على التعليقات من المستوى الأعلى. (يُرجى العِلم أنّ مرجع commentThread لا يحتوي بالضرورة على كل الردود على تعليق، وعليك استخدام الطريقة comments.list إذا كنت تريد استرداد كل الردود على تعليق معيّن).

• videoId: حدِّد معرّف فيديو YouTube الذي تريد استرداد تعليقاته.

يسترجع الطلب أدناه التعليقات والردود على التعليقات المرتبطة بالفيديو الخاص بالخطاب الرئيسي في مؤتمر Google I/O لعام 2014، والذي يحمل معرّف الفيديو wtLJPvx7-ys.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&videoId=wtLJPvx7-ys

استرداد التعليقات حول قناة معيّنة أو المرتبطة بها

تتيح واجهة برمجة التطبيقات إمكانية استرداد سلاسل ردود على التعليقات حول قناة معيّنة أو استرداد كل سلاسل ردود على التعليقات المرتبطة بقناة معيّنة. وفي الحالة الأخيرة، يمكن أن تحتوي واجهة برمجة التطبيقات على تعليقات حول القناة أو حول أي من فيديوهاتها.

• لاسترداد التعليقات حول قناة معيّنة، اتّبِع تعليمات استرداد التعليقات حول فيديو معيّن. ومع ذلك، بدلاً من ضبط المَعلمة videoId، اضبط المَعلمة channelId لتحديد القناة.

• لاسترداد التعليقات المرتبطة بقناة، اتّبِع تعليمات استرداد التعليقات على فيديو. بدلاً من ضبط المَعلمة videoId، اضبط المَعلمة allThreadsRelatedToChannelId لتحديد القناة.

يستردّ الطلب أدناه جميع سلاسل التعليقات المرتبطة بقناة GoogleDevelopers على YouTube:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&allThreadsRelatedToChannelId=UC_x5XG1OV2P6uZZ5FSM9Ttw

إضافة تعليق

استخدِم الطريقة commentThreads.insert لإضافة تعليق جديد من المستوى الأعلى إلى قناة أو فيديو. اضبط قيمة المَعلمة part للطلب على snippet. نص الطلب هو commentThread resource تتضمّن السمة snippet.topLevelComment[].snippet[].textOriginal نص التعليق. يجب تفويض هذا الطلب باستخدام بروتوكول OAuth 2.0.

• لإضافة تعليق إلى قناة، استخدِم السمة snippet.channelId لتحديد القناة.
• لإضافة تعليق إلى فيديو، استخدِم السمة snippet.channelId لتحديد القناة التي حمّلت الفيديو. استخدِم أيضًا السمة snippet.videoId لتحديد الفيديو.

يضيف نموذج الطلب التالي تعليقًا إلى فيديو.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.insert?
part=snippet

يُدرج الطلب المورد الموضّح أدناه.

{
 "snippet": {
  "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
  "topLevelComment": {
   "snippet": {
    "textOriginal": "This video is awesome!"
   }
  },
  "videoId": "MILSirUni5E"
 }
}

الردّ على تعليق

استخدِم الطريقة comments.insert للردّ على تعليق. اضبط قيمة المَعلمة part للطلب على snippet. نص الطلب هو comment resource تتضمّن السمة snippet.textOriginal نص التعليق. تحدِّد السمة snippet.parentId التعليق المرتبط بالردّ، وتكون قيمتها commentThread resource's ID. يجب تفويض هذا الطلب باستخدام بروتوكول OAuth 2.0.

يضيف نموذج الطلب التالي ردًا على تعليق حالي.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.insert?
part=snippet

يُدرج الطلب المورد الموضّح أدناه. لتنفيذ الطلب في "مستكشف واجهات برمجة التطبيقات"، استخدِم قيمة السمة snippet.parentId لتحديد التعليق من المستوى الأعلى المرتبط بالردّ. في مورد commentThread، تحدّد السمة snippet.topLevelComment[].id المعرّف الفريد للمورد.

{
  "snippet": {
    "parentId": "COMMENT_THREAD_ID",
    "textOriginal": "That is true."
  }
}

تعديل تعليق أو ردّ على تعليق من المستوى الأعلى

لتعديل نص تعليق من المستوى الأعلى أو ردّ على تعليق من المستوى الأعلى، يمكنك استدعاء الطريقة comments.update. اضبط قيمة المَعلمة part على snippet. في نص الطلب، تحدّد السمة id التعليق الذي تعدّله ونص التعليق الجديد.

• في مورد commentThread الذي يحدّد تعليقًا من المستوى الأعلى، تحدّد السمة snippet.topLevelComment[].id رقم التعريف الفريد للتعليق.
• في مورد comment الذي يمكنه تحديد تعليق من المستوى الأعلى أو ردّ على تعليق، تحدّد السمة id المعرّف الفريد للتعليق.

يُعدّ نموذج الطلب أدناه مثالاً على تعديل نص تعليق حالي.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.update?
part=snippet

يحتوي نص الطلب على مقتطف JSON الموضح أدناه. لتنفيذ الطلب في "مستكشف واجهات برمجة التطبيقات"، اضبط قيمة السمة id لتحديد التعليق الذي تعدّله. يجب أن يوافق كاتب التعليق على الطلب.

{
  "id": "COMMENT_ID",
  "snippet": {
    "textOriginal": "That is true."
  }
}

ضبط حالة الإشراف على تعليق

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

عند استدعاء هذه الطريقة، اضبط قيمة المَعلمة id لتحديد التعليق. اضبط أيضًا المَعلمة moderationStatus على الحالة المطلوبة. لا يمكن تعديل حالة تعليق إلّا من قِبل مالك القناة التي يظهر فيها التعليق.

• الخطوة 1: استرداد التعليقات التي تمّت إحالتها إلى المراجعة

  استخدِم الطريقة commentThreads.list لاسترداد التعليقات على القناة أو الفيديو. اضبط قيمة المَعلمة moderationStatus على heldForReview. يمكن استخدام استجابة واجهة برمجة التطبيقات لعرض قائمة بالتعليقات مع خيار يسمح لمالك القناة بنشر كل تعليق أو رفضه.

• الخطوة 2: تعديل حالة الإشراف على تعليق

  استخدِم الطريقة comments.setModerationStatus لتعديل حالة التعليق. استخدِم قيمة المَعلمة id لتحديد المعرّف الفريد للتعليق. اضبط المَعلمة moderationStatus على published أو rejected. إذا كنت ترفض تعليقًا، يمكنك أيضًا ضبط المَعلمة banAuthor على true لمنع كاتب التعليق من نشر تعليقات إضافية على القناة أو الفيديو.

ملاحظة: لا توفّر واجهة برمجة التطبيقات طريقة لإدراج التعليقات المرفوضة أو اكتشافها. ومع ذلك، سيظل بإمكانك تغيير حالة الإشراف على تعليق مرفوض إلى published إذا كان المعرّف الفريد للتعليق معروفًا. بالإضافة إلى ذلك، بعد تعديل حالة الإشراف على التعليق إلى published أو rejected، لا يمكن تغيير حالة الإشراف مرة أخرى إلى heldForReview.

إزالة التعليق

يوضّح هذا المثال كيفية حذف تعليق. يتضمّن المثال الخطوات التالية:

• الخطوة 1: استرداد رقم تعريف التعليق

  اتّبِع الخطوات أعلاه لاسترداد قائمة بالتعليقات على فيديو أو قناة. تذكَّر أنّه لا يمكن إلّا لكاتب التعليق حذفه، لذا عليك مقارنة قيمة سمة snippet.authorChannelId.value لمورد comment بمعرّف قناة المستخدم الذي تمّت مصادقة هويته لتحديد ما إذا كان بإمكان المستخدم حذف هذا التعليق المحدّد.

• الخطوة 2: حذف التعليق أو سلسلة التعليقات

  بعد تحديد رقم تعريف سلسلة التعليقات أو التعليق الذي تريد حذفه، يمكنك استدعاء طريقة comments.delete لحذف هذا التعليق. استخدِم قيمة المَعلمة id لتحديد معرّف التعليق أو معرّف سلسلة المحادثات التي تريد حذفها. يجب تفويض الطلب باستخدام OAuth 2.0. إذا كنت تختبر هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال معرّف تعليق صالح أو معرّف سلسلة محادثات تعليقات بقيمة المَعلمة id في الطلب أدناه.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.delete?
  id=COMMENT_ID