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

لم يعُد طلب 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

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

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

يسترد الطلب أدناه جميع سلاسل التعليقات المرتبطة بقناة 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