Comments: list

API অনুরোধের পরামিতিগুলির সাথে মেলে এমন মন্তব্যগুলির একটি তালিকা প্রদান করে৷

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

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

অনুরোধ

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 প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, 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 কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।