প্রয়োগ: কমেন্ট

comments.markAsSpam পদ্ধতি আর কাজ করে না।

কমেন্ট সংক্রান্ত ফাংশন পারফর্ম করতে কীভাবে YouTube Data API (v3) ব্যবহার করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

কোনও ভিডিওর কমেন্ট ফিরিয়ে আনা

ভিডিওর জন্য কমেন্ট থ্রেডের তালিকা পেতে, commentThreads.list মেথড কল করুন। আপনার অনুরোধে নিম্নলিখিত প্যারামিটার ভ্যালু সেট করুন:

  • part: আপনি যদি শুধুমাত্র টপ-লেভেল কমেন্ট পেতে চান তাহলে প্যারামিটার ভ্যালু snippet হিসেবে সেট করুন অথবা টপ-লেভেল কমেন্টের উত্তরও পেতে চাইলে snippet,replies হিসেবে সেট করুন। (মনে রাখবেন যে commentThread রিসোর্সে কোনও কমেন্টের সব উত্তর নাও থাকতে পারে এবং কোনও নির্দিষ্ট কমেন্টের সব উত্তর পেতে চাইলে আপনাকে comments.list পদ্ধতি ব্যবহার করতে হবে।)

  • videoId: আপনি যে ভিডিওর কমেন্ট রিট্রিভ করছেন সেটির YouTube ভিডিও আইডি উল্লেখ করুন।

নিচে দেওয়া অনুরোধটি ২০১৪ সালের Google I/O কনফারেন্সে মূল বক্তব্য সম্পর্কিত ভিডিওর কমেন্ট ও কমেন্টের উত্তর পুনরুদ্ধার করে, যার ভিডিও আইডি হল wtLJPvx7-ys।

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

কোনও চ্যানেল সম্পর্কে বা তার সাথে সম্পর্কিত কমেন্ট ফিরিয়ে আনা

API-এর সাহায্যে কোনও চ্যানেল সম্পর্কে কমেন্ট থ্রেড অথবা কোনও চ্যানেলের সাথে যুক্ত সব কমেন্ট থ্রেড রিট্রিভ করা যায়। পরের ক্ষেত্রে, API-তে চ্যানেল বা চ্যানেলের যেকোনও ভিডিও সম্পর্কে কমেন্ট থাকতে পারে।

  • কোনও চ্যানেল সম্পর্কে কমেন্ট পেতে, কোনও ভিডিওর জন্য কমেন্ট পাওয়া সংক্রান্ত নির্দেশাবলী অনুসরণ করুন। তবে, 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

অনুরোধটি নিচে দেখানো রিসোর্স যোগ করে। APIs Explorer-এ অনুরোধ কার্যকর করতে, উত্তরের সাথে যুক্ত টপ-লেভেল কমেন্ট শনাক্ত করার জন্য 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 স্নিপেট থাকে। APIs Explorer-এ অনুরোধ কার্যকর করতে, আপনি যে কমেন্ট আপডেট করছেন তা শনাক্ত করার জন্য id প্রপার্টির ভ্যালু সেট করুন। কমেন্টের লেখককে অনুরোধটি অনুমোদন করতে হবে।

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

কমেন্টের মডারেশন স্ট্যাটাস সেট করা

কোনও কমেন্টের মডারেশন স্ট্যাটাস সেট করতে, comments.setModerationStatus পদ্ধতি কল করুন। চ্যানেলের মালিক চ্যানেলে বা চ্যানেলের ভিডিওতে কমেন্ট মডারেট করলে এই অ্যাকশন ব্যবহার করা হয়।

এই মেথড কল করার সময়, কমেন্ট শনাক্ত করতে id প্যারামিটারের ভ্যালু সেট করুন। এছাড়াও, moderationStatus প্যারামিটারটি আপনার পছন্দসই স্ট্যাটাসে সেট করুন। যে চ্যানেলে কমেন্টটি দেখা যাচ্ছে, শুধুমাত্র সেই চ্যানেলের মালিকই কমেন্টের স্ট্যাটাস অ্যাডজাস্ট করতে পারবেন।

  • ধাপ ১: পর্যালোচনার জন্য হোল্ডে রাখা কমেন্ট ফিরিয়ে আনা

    চ্যানেল বা ভিডিওর কমেন্ট রিট্রিভ করতে commentThreads.list মেথড কল করুন। moderationStatus প্যারামিটারের ভ্যালু heldForReview-এ সেট করুন। API থেকে পাওয়া উত্তর ব্যবহার করে কমেন্টের একটি তালিকা দেখানো যেতে পারে এবং চ্যানেল মালিকের কাছে প্রতিটি কমেন্ট প্রকাশ করা বা বাতিল করার বিকল্প থাকতে পারে।

  • ধাপ ২: কোনও কমেন্টের মডারেশন স্ট্যাটাস আপডেট করা

    কমেন্টের স্ট্যাটাস আপডেট করতে comments.setModerationStatus মেথড কল করুন। কমেন্টের অনন্য আইডি নির্দিষ্ট করতে id প্যারামিটারের মান ব্যবহার করুন। moderationStatus প্যারামিটারকে published বা rejected হিসেবে সেট করুন। আপনি কোনও কমেন্ট বাতিল করলে, চ্যানেলে বা ভিডিওতে লেখককে অতিরিক্ত কমেন্ট করা থেকে আটকাতে, banAuthor প্যারামিটারকে true হিসেবে সেট করতে পারেন।

মনে রাখবেন: API-তে বাতিল করা কমেন্টের তালিকা তৈরি করা বা অন্য কোনও উপায়ে তা খুঁজে বের করার কোনও উপায় নেই। তবে, কমেন্টের অনন্য আইডি জানা থাকলে, আপনি এখনও প্রত্যাখ্যান করা কমেন্টের মডারেশন স্ট্যাটাস পরিবর্তন করে published করতে পারবেন। এছাড়াও, কোনও কমেন্টের মডারেশন স্ট্যাটাস একবার আপডেট করে published বা rejected করা হলে, মডারেশন স্ট্যাটাস আর পরিবর্তন করে heldForReview করা যায় না।

কমেন্ট সরানো

এই উদাহরণে দেখানো হয়েছে কীভাবে কমেন্ট মুছতে হয়। উদাহরণে নিম্নলিখিত ধাপগুলি রয়েছে:

  • ধাপ ১: কমেন্ট আইডি খুঁজে বের করা

    ভিডিও বা চ্যানেলের জন্য কমেন্টের তালিকা পেতে উপরে উল্লেখ করা ধাপগুলি অনুসরণ করুন। মনে রাখবেন যে, কোনও কমেন্ট শুধুমাত্র তার লেখকই মুছে দিতে পারেন, তাই ব্যবহারকারী সেই নির্দিষ্ট কমেন্ট মুছে দিতে পারবেন কিনা তা নির্ধারণ করতে আপনাকে comment রিসোর্সের snippet.authorChannelId.value প্রপার্টির ভ্যালু যাচাইকৃত ব্যবহারকারীর চ্যানেল আইডির সাথে তুলনা করতে হবে।

  • ধাপ ২: কমেন্ট বা কমেন্ট থ্রেড মুছে দিন

    আপনি যে কমেন্ট থ্রেড বা কমেন্ট মুছে দিতে চান সেটির আইডি শনাক্ত করার পরে, সেই কমেন্টটি মুছে দিতে comments.delete মেথড কল করুন। আপনি যে কমেন্ট আইডি বা কমেন্ট থ্রেড আইডি মুছছেন তা শনাক্ত করতে id প্যারামিটার ভ্যালু ব্যবহার করুন। অনুরোধটি অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে। আপনি যদি APIs Explorer-এ এই কোয়েরি পরীক্ষা করেন, তাহলে আপনাকে নিচের অনুরোধে id প্যারামিটারের মানের জন্য একটি সঠিক কমেন্ট আইডি বা কমেন্ট থ্রেড আইডি দিয়ে প্রতিস্থাপন করতে হবে।

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