বাস্তবায়ন: মন্তব্য

comments.markAsSpam পদ্ধতি আর সমর্থিত নয়।

নিম্নলিখিত উদাহরণগুলি দেখায় যে কীভাবে YouTube ডেটা API (v3) ব্যবহার করতে হয় মন্তব্য সম্পর্কিত ফাংশনগুলি সম্পাদন করতে৷

একটি ভিডিওর জন্য মন্তব্য পুনরুদ্ধার করুন

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

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

  • videoId : আপনি যে ভিডিওটির জন্য মন্তব্য পুনরুদ্ধার করছেন তার YouTube ভিডিও আইডি নির্দিষ্ট করুন৷

নীচের অনুরোধটি 2014 Google I/O সম্মেলনের মূল বক্তব্যের ভিডিও সম্পর্কিত মন্তব্য এবং মন্তব্যের উত্তরগুলি পুনরুদ্ধার করে, যার ভিডিও আইডি wtLJPvx7-ys রয়েছে।

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

একটি চ্যানেল সম্পর্কে বা সংশ্লিষ্ট মন্তব্য পুনরুদ্ধার করুন

API একটি চ্যানেল সম্পর্কে মন্তব্য থ্রেড পুনরুদ্ধার বা একটি চ্যানেলের সাথে যুক্ত সমস্ত মন্তব্য থ্রেড পুনরুদ্ধার করার ক্ষমতা সমর্থন করে। পরবর্তী ক্ষেত্রে, এপিআই চ্যানেল বা চ্যানেলের যেকোনো ভিডিও সম্পর্কে মন্তব্য ধারণ করতে পারে।

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

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

একটি মন্তব্যের সংযম অবস্থা সেট করুন

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

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

  • ধাপ 1: পর্যালোচনার জন্য রাখা হয়েছে এমন মন্তব্য পুনরুদ্ধার করুন

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

  • ধাপ 2: একটি মন্তব্যের মডারেশন স্ট্যাটাস আপডেট করুন

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

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

একটি মন্তব্য সরান

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

  • ধাপ 1: মন্তব্য আইডি পুনরুদ্ধার করুন

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

  • ধাপ 2: মন্তব্য বা মন্তব্য থ্রেড মুছুন

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

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