Comments: list

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

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

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

অনুরোধ করুন

HTTP অনুরোধ

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

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

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

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

অনুরোধের বডি

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

রেসপন্স

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

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

প্রপার্টি

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

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

সমস্যা

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

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
badRequest (400)	operationNotSupported	আইডি ফিল্টার শুধুমাত্র Google+ ভিত্তিক কমেন্টের সাথে মানানসই।
forbidden (403)	forbidden	প্রয়োজনীয় অনুমতি না থাকার কারণে অনুরোধ করা এক বা একাধিক কমেন্ট ফিরিয়ে আনা যায়নি। অনুরোধটি সঠিকভাবে অনুমোদিত নাও হতে পারে।
notFound (404)	commentNotFound	নির্দিষ্ট করা এক বা একাধিক কমেন্ট খুঁজে পাওয়া যায়নি। অনুরোধের id এবং parentId প্যারামিটারের ভ্যালু সঠিক কিনা তা চেক করুন।

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

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