CommentThreads: list

API অনুরোধের প্যারামিটারের সাথে মিলে যাওয়া কমেন্ট থ্রেডের তালিকা রিটার্ন করে।

কোটার উপর প্রভাব: এই পদ্ধতিতে কল করলে ১ ইউনিট কোটা খরচ হয়।

সাধারণ ব্যবহারিক ক্ষেত্র

অনুরোধ করুন

HTTP অনুরোধ

GET https://www.googleapis.com/youtube/v3/commentThreads

প্যারামিটারগুলি

এই কোয়েরিতে যেসব প্যারামিটার কাজ করে তা নিম্নলিখিত সারণীতে দেওয়া হল। তালিকায় থাকা সব প্যারামিটারই হল কোয়েরি প্যারামিটার।

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part	string part প্যারামিটারটি এক বা একাধিক commentThread রিসোর্স প্রপার্টির কমা দ্বারা আলাদা করা তালিকা নির্দিষ্ট করে যা API রেসপন্সে অন্তর্ভুক্ত থাকবে। নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার ভ্যালুতে অন্তর্ভুক্ত করতে পারবেন: id replies snippet
ফিল্টার (নিম্নলিখিত প্যারামিটারগুলির মধ্যে ঠিক একটি নির্দিষ্ট করুন)
allThreadsRelatedToChannelId	string allThreadsRelatedToChannelId প্যারামিটার API-কে নির্দেশ দেয় যাতে নির্দিষ্ট চ্যানেলের সাথে সম্পর্কিত সব কমেন্ট থ্রেড দেখানো হয়।
id	string id প্যারামিটার, সেইসব রিসোর্সের জন্য কমেন্ট থ্রেড আইডির কমা-সেপারেটেড তালিকা নির্দিষ্ট করে যেগুলি রিট্রিভ করা উচিত।
videoId	string videoId প্যারামিটারটি API-কে নির্দিষ্ট ভিডিও আইডির সাথে সম্পর্কিত কমেন্ট থ্রেড ফিরিয়ে দেওয়ার নির্দেশ দেয়।
ঐচ্ছিক প্যারামিটার
maxResults	unsigned integer maxResults প্যারামিটারটি ফলাফল সেটে ফেরত আসা আইটেমের সর্বাধিক সংখ্যা নির্দিষ্ট করে। মনে রাখবেন: id প্যারামিটারের সাথে এই প্যারামিটারটি ব্যবহার করা যাবে না। গ্রহণযোগ্য ভ্যালু হল 1 থেকে 100, অন্তর্ভুক্ত। ডিফল্ট ভ্যালু হল 20।
moderationStatus	string এই প্যারামিটার শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। রিটার্ন করা কমেন্ট থ্রেডকে নির্দিষ্ট মডারেশন স্টেটে সীমাবদ্ধ রাখতে এই প্যারামিটার সেট করুন। মনে রাখবেন: এই প্যারামিটারটি id প্যারামিটারের সাথে একসাথে ব্যবহার করা যায় না। ডিফল্ট ভ্যালু হল published। গ্রহণযোগ্য ভ্যালু হল: heldForReview – মডারেটরের পর্যালোচনার জন্য অপেক্ষা করছে এমন কমেন্ট থ্রেড ফিরিয়ে আনুন। টপ-লেভেল কমেন্ট বা সেই কমেন্টের অন্তত একটি উত্তর পর্যালোচনার জন্য অপেক্ষারত থাকলে, উত্তরে কমেন্ট থ্রেড অন্তর্ভুক্ত করা যেতে পারে। likelySpam – স্প্যাম হিসেবে শ্রেণীবদ্ধ করা কমেন্ট থ্রেড ফিরিয়ে আনে। কোনও কমেন্ট থ্রেডকে উত্তরে অন্তর্ভুক্ত করা যেতে পারে যদি টপ-লেভেল কমেন্ট বা সেই কমেন্টের অন্তত একটি উত্তরকে স্প্যাম হিসেবে বিবেচনা করা হয়। published – প্রকাশিত কমেন্টের থ্রেড ফিরিয়ে আনা। এটি হল ডিফল্ট ভ্যালু। কোনও কমেন্ট থ্রেডের টপ-লেভেল কমেন্ট প্রকাশ করা হলে, সেটি উত্তরে অন্তর্ভুক্ত করা হতে পারে।
order	string order প্যারামিটারটি সেই ক্রম নির্দিষ্ট করে যেটিতে API উত্তর কমেন্ট থ্রেড তালিকাভুক্ত করবে। সঠিক মান হল: time - কমেন্ট থ্রেড সময় অনুযায়ী সাজানো হয়। এটি হল ডিফল্ট অ্যাকশন। relevance - প্রাসঙ্গিকতা অনুযায়ী কমেন্ট থ্রেড সাজানো হয়েছে। মনে রাখবেন: id প্যারামিটারের সাথে এই প্যারামিটার ব্যবহার করা যাবে না।
pageToken	string pageToken প্যারামিটারটি ফলাফল সেটের একটি নির্দিষ্ট পৃষ্ঠা শনাক্ত করে যা ফেরত দেওয়া উচিত। API রেসপন্সে, nextPageToken প্রপার্টি ফলাফলের পরবর্তী পৃষ্ঠা শনাক্ত করে যা ফিরিয়ে আনা যাবে। মনে রাখবেন: id প্যারামিটারের সাথে এই প্যারামিটার ব্যবহার করা যাবে না।
searchTerms	string searchTerms প্যারামিটার API-কে নির্দেশ দেয় যাতে API রেসপন্স শুধু সেইসব কমেন্টের মধ্যে সীমাবদ্ধ থাকে যেগুলিতে নির্দিষ্ট সার্চ করা শব্দ আছে। মনে রাখবেন: id প্যারামিটারের সাথে এই প্যারামিটার ব্যবহার করা যায় না।
textFormat	string এই প্যারামিটারের ভ্যালু html বা plainText হিসেবে সেট করুন যাতে API ব্যবহারকারীর করা কমেন্ট HTML ফর্ম্যাট বা প্লেন টেক্সট হিসেবে দেখায়। ডিফল্ট ভ্যালু হল html। গ্রহণযোগ্য ভ্যালু হল: html – HTML ফর্ম্যাটে কমেন্ট রিটার্ন করে। এটি হল ডিফল্ট ভ্যালু। plainText – প্লেন টেক্সট ফর্ম্যাটে কমেন্ট দেখায়।

অনুরোধের বডি

এই পদ্ধতি কল করার সময় অনুরোধের বডি প্রদান করবেন না।

রেসপন্স

সফল হলে, এই পদ্ধতিটি নিম্নলিখিত স্ট্রাকচার সহ একটি রেসপন্স বডি প্রদান করে:

{
  "kind": "youtube#commentThreadListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    commentThread Resource
  ]
}

প্রপার্টি

নিম্নলিখিত সারণীতে এই রিসোর্সে দেখানো প্রপার্টিগুলি সংজ্ঞায়িত করা হয়েছে:

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু youtube#commentThreadListResponse হবে।
etag	etag এই রিসোর্সের Etag.
nextPageToken	string ফলাফল সেটের পরবর্তী পৃষ্ঠা ফিরিয়ে আনতে pageToken প্যারামিটারের ভ্যালু হিসেবে যে টোকেন ব্যবহার করা যেতে পারে।
pageInfo	object pageInfo অবজেক্টে ফলাফল সেটের জন্য পেজিং সংক্রান্ত তথ্য থাকে।
pageInfo.totalResults	integer ফলাফলের সেটে মোট ফলাফলের সংখ্যা।
pageInfo.resultsPerPage	integer API রেসপন্সে অন্তর্ভুক্ত ফলাফলের সংখ্যা।
items[]	list অনুরোধের মাপকাঠির সাথে মেলে এমন কমেন্ট থ্রেডের তালিকা।

সমস্যা

এই পদ্ধতিতে কল করার উত্তরে API যেসব সমস্যার মেসেজ রিটার্ন করতে পারে, তা নিম্নলিখিত সারণীতে শনাক্ত করা হয়েছে। আরও বিবরণের জন্য, সমস্যার মেসেজ সংক্রান্ত ডকুমেন্টেশন দেখুন।

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
badRequest (400)	operationNotSupported	id ফিল্টার শুধুমাত্র Google+ ভিত্তিক কমেন্টের সাথে মানানসই।
badRequest (400)	processingFailure	API সার্ভার অনুরোধটি প্রসেস করতে পারেনি। এটি সাময়িক সমস্যা হলেও, সাধারণত এর অর্থ হল অনুরোধের ইনপুট সঠিক নয়। অনুরোধের বডিতে commentThread রিসোর্সের স্ট্রাকচার চেক করে দেখুন যে সেটি সঠিক কিনা।
forbidden (403)	commentsDisabled	videoId প্যারামিটার দ্বারা শনাক্ত করা ভিডিওতে কমেন্ট করার সুবিধা বন্ধ করা আছে।
forbidden (403)	forbidden	অনুরোধ করা এক বা একাধিক কমেন্ট থ্রেড পর্যাপ্ত অনুমতি না থাকার কারণে পুনরুদ্ধার করা যায়নি। অনুরোধটি হয়ত সঠিকভাবে অনুমোদিত নয়।
notFound (404)	channelNotFound	allThreadsRelatedToChannelId প্যারামিটার দ্বারা শনাক্ত করা চ্যানেলটি খুঁজে পাওয়া যায়নি।
notFound (404)	commentThreadNotFound	উল্লেখ করা এক বা একাধিক কমেন্ট থ্রেড খুঁজে পাওয়া যায়নি। অনুরোধের id প্যারামিটারের ভ্যালু সঠিক কিনা তা নিশ্চিত করুন।
notFound (404)	videoNotFound	videoId প্যারামিটার দ্বারা শনাক্ত করা ভিডিও খুঁজে পাওয়া যায়নি।

এটি ব্যবহার করে দেখুন!

এই API কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।