CommentThreads: list

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

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

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

অনুরোধ

HTTP অনুরোধ

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

পরামিতি

নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটারটি এক বা একাধিক commentThread সম্পদ বৈশিষ্ট্যের একটি কমা-বিচ্ছিন্ন তালিকা নির্দিষ্ট করে যা API প্রতিক্রিয়া অন্তর্ভুক্ত করবে।

নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার মান অন্তর্ভুক্ত করতে পারেন:
  • id
  • replies
  • snippet
ফিল্টার (নিম্নলিখিত পরামিতিগুলির মধ্যে একটি নির্দিষ্ট করুন)
allThreadsRelatedToChannelId string
allThreadsRelatedToChannelId প্যারামিটার API-কে নির্দিষ্ট চ্যানেলের সাথে যুক্ত সমস্ত মন্তব্য থ্রেড ফেরত দেওয়ার নির্দেশ দেয়। প্রতিক্রিয়া চ্যানেল সম্পর্কে বা চ্যানেলের ভিডিও সম্পর্কে মন্তব্য অন্তর্ভুক্ত করতে পারে।
channelId string
channelId প্যারামিটার 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 প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, nextPageToken প্রপার্টি ফলাফলের পরবর্তী পৃষ্ঠাটিকে চিহ্নিত করে যা পুনরুদ্ধার করা যেতে পারে।

দ্রষ্টব্য: এই প্যারামিটারটি id প্যারামিটারের সাথে ব্যবহারের জন্য সমর্থিত নয়।
searchTerms string
searchTerms প্যারামিটার API-কে নির্দেশ দেয় API প্রতিক্রিয়া সীমিত করার জন্য শুধুমাত্র নির্দিষ্ট সার্চ টার্ম ধারণ করে এমন মন্তব্যের জন্য।

দ্রষ্টব্য: এই প্যারামিটারটি id প্যারামিটারের সাথে ব্যবহারের জন্য সমর্থিত নয়।
textFormat string
এই প্যারামিটারের মানটি html বা plainText সেট করুন যাতে ব্যবহারকারীরা html ফরম্যাটে বা প্লেইন টেক্সটে করা মন্তব্য ফেরত দিতে API-কে নির্দেশ দেয়। ডিফল্ট মান হল 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 আইডি ফিল্টারটি শুধুমাত্র Google+ ভিত্তিক মন্তব্যের সাথে সামঞ্জস্যপূর্ণ।
badRequest (400) processingFailure API সার্ভার সফলভাবে অনুরোধ প্রক্রিয়া করতে ব্যর্থ হয়েছে. যদিও এটি একটি ক্ষণস্থায়ী ত্রুটি হতে পারে, এটি সাধারণত নির্দেশ করে যে অনুরোধের ইনপুটটি অবৈধ৷ এটি বৈধ কিনা তা নিশ্চিত করতে অনুরোধের অংশে commentThread সংস্থানের গঠন পরীক্ষা করুন।
forbidden (403) commentsDisabled videoId প্যারামিটার দ্বারা চিহ্নিত ভিডিওটি মন্তব্যগুলি অক্ষম করেছে৷
forbidden (403) forbidden এক বা একাধিক অনুরোধকৃত মন্তব্য থ্রেড অপর্যাপ্ত অনুমতির কারণে পুনরুদ্ধার করা যাবে না। অনুরোধ সঠিকভাবে অনুমোদিত নাও হতে পারে.
notFound (404) channelNotFound channelId বা allThreadsRelatedToChannelId প্যারামিটার দ্বারা চিহ্নিত চ্যানেলটি খুঁজে পাওয়া যায়নি।
notFound (404) commentThreadNotFound এক বা একাধিক নির্দিষ্ট মন্তব্য থ্রেড পাওয়া যাবে না. অনুরোধের id প্যারামিটারের মান পরীক্ষা করে নিশ্চিত করুন যে এটি সঠিক।
notFound (404) videoNotFound videoId প্যারামিটার দ্বারা চিহ্নিত ভিডিওটি খুঁজে পাওয়া যায়নি৷

এটা চেষ্টা করুন!

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