LiveChatMessages: list

নির্দিষ্ট চ্যাটের জন্য লাইভ চ্যাট মেসেজ তালিকাভুক্ত করে।

চ্যাট মেসেজ ফিরিয়ে আনার জন্য আপনি প্রথম অনুরোধ করলে, API চ্যাট ইতিহাসের দৈর্ঘ্য অনুযায়ী কিছু বা সব ইতিহাস রিটার্ন করে। উত্তরে মেসেজগুলি সবচেয়ে পুরনো থেকে সবচেয়ে নতুন হিসেবে সাজানো হয়েছে।
  • উত্তরে nextPageToken একটি টোকেন প্রদান করে যা আপনার পরবর্তী অনুরোধে, ফলাফলের পরবর্তী সেট শনাক্ত করবে যা আপনার API ক্লায়েন্টকে খুঁজে বের করতে হবে।
  • pollingIntervalMillis প্রপার্টি থেকে বোঝা যায় যে অতিরিক্ত ফলাফল পাওয়ার অনুরোধ করার আগে আপনার API ক্লায়েন্টকে কতক্ষণ অপেক্ষা করতে হবে।
আপনি অতিরিক্ত ফলাফল চাইলে, pageToken প্যারামিটারকে nextPageToken ভ্যালু হিসেবে সেট করেন এবং API সার্ভার অতিরিক্ত চ্যাট মেসেজ রিটার্ন করে, যদি উপলভ্য থাকে। আবার, সেই ফলাফল সেটের মধ্যে, মেসেজগুলি সবচেয়ে পুরনো থেকে সবচেয়ে নতুন হিসেবে সাজানো হয়।

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

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

অনুরোধ করুন

HTTP অনুরোধ

GET https://www.googleapis.com/youtube/v3/liveChat/messages

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

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

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
liveChatId string
liveChatId প্যারামিটারটি সেই চ্যাটের আইডি নির্দিষ্ট করে যার মেসেজ ফেরত দেওয়া হবে। ব্রডকাস্টের সাথে যুক্ত লাইভ চ্যাট আইডি liveBroadcast রিসোর্সের snippet.liveChatId প্রপার্টিতে ফেরত পাঠানো হয়।
part string
part প্যারামিটার liveChatMessage রিসোর্স পার্ট নির্দিষ্ট করে যা API রেসপন্সে অন্তর্ভুক্ত থাকবে। সাপোর্ট করা ভ্যালু হল id, snippet এবং authorDetails।
ঐচ্ছিক প্যারামিটার
hl string
hl প্যারামিটারটি API-কে নির্দেশ দেয় যাতে সেটি YouTube ওয়েবসাইট সাপোর্ট করে এমন নির্দিষ্ট অ্যাপ্লিকেশন ভাষার জন্য একটি লোকালাইজ করা মুদ্রা প্রদর্শন স্ট্রিং ফিরিয়ে আনে। যেমন, ইংরেজিতে, মুদ্রা $1.50 হিসেবে দেখানো হবে, কিন্তু ফরাসি ভাষায়, এটি 1,50$ হিসেবে দেখানো হবে।

প্যারামিটার ভ্যালু অবশ্যই i18nLanguages.list মেথডের মাধ্যমে ফিরে আসা তালিকায় অন্তর্ভুক্ত একটি ভাষা কোড হতে হবে।
maxResults unsigned integer

maxResults প্যারামিটারটি ফলাফল সেটে সর্বাধিক কতগুলি মেসেজ দেখানো হবে তা নির্দিষ্ট করে। গ্রহণযোগ্য ভ্যালু হল 200 থেকে 2000, অন্তর্ভুক্ত। ডিফল্ট মান হল 500।

কন্টিনিউয়েশন টোকেন ছাড়া করা প্রাথমিক অনুরোধে শুধুমাত্র সাম্প্রতিক মেসেজ থাকবে। এটি দেওয়া হলে, maxResults-এর থেকে ছোট হতে পারে।

কন্টিনিউয়েশন টোকেন ছাড়া করা প্রাথমিক অনুরোধের মাধ্যমে যেসব মেসেজ ফেরত দেওয়া হয়েছে, API তার থেকে পুরনো মেসেজ আর পায় না।
pageToken string
pageToken প্যারামিটারটি ফলাফল সেটের একটি নির্দিষ্ট পৃষ্ঠা শনাক্ত করে যা ফেরত দেওয়া উচিত। API রেসপন্সে, nextPageToken প্রপার্টি অন্যান্য পৃষ্ঠা শনাক্ত করে যা ফিরিয়ে আনা যেতে পারে।
profileImageSize unsigned integer
profileImageSize প্যারামিটার ব্যবহারকারীর প্রোফাইল ছবির সাইজ নির্দিষ্ট করে যা ফলাফল সেটে রিটার্ন করা উচিত। ছবিগুলি বর্গাকার। ডিফল্ট ভ্যালু হল 88, অর্থাৎ ছবির সাইজ হবে ৮৮ পিক্সেল বাই ৮৮ পিক্সেল। গ্রহণযোগ্য ভ্যালু 16 থেকে 720 রেঞ্জের মধ্যে, অন্তর্ভুক্ত।

অনুরোধের বডি

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

রেসপন্স

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

{
  "kind": "youtube#liveChatMessageListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pollingIntervalMillis": unsigned integer,
  "offlineAt": datetime,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    liveChatMessage Resource
  ],
  "activePollItem": liveChatMessage Resource
}

প্রপার্টি

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

প্রপার্টি
kind string
API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু youtube#liveChatMessageListResponse হবে।
etag etag
এই রিসোর্সের Etag.
nextPageToken string
ফলাফল সেটের পরবর্তী পৃষ্ঠা ফিরিয়ে আনতে pageToken প্যারামিটারের ভ্যালু হিসেবে যে টোকেন ব্যবহার করা যেতে পারে।
pollingIntervalMillis unsigned integer
নতুন লাইভ চ্যাট মেসেজের জন্য আবার পোল করার আগে ক্লায়েন্টকে যত সময় অপেক্ষা করতে হবে, মিলিসেকেন্ডে।
offlineAt datetime
যে তারিখ ও সময়ে অন্তর্নিহিত লাইভ স্ট্রিম অফলাইন হয়ে গেছে। স্ট্রিম আগে থেকেই অফলাইন থাকলে তবেই এই প্রপার্টি থাকে। মানটি ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) ফর্ম্যাটে নির্দিষ্ট করা আছে।
pageInfo object
pageInfo অবজেক্টে ফলাফল সেটের জন্য পেজিং সংক্রান্ত তথ্য থাকে।
pageInfo.totalResults integer
ফলাফলের সেটে ফলাফলের মোট সংখ্যা।
pageInfo.resultsPerPage integer
API রেসপন্সে অন্তর্ভুক্ত ফলাফলের সংখ্যা।
items[] list
মেসেজের তালিকা। তালিকার প্রতিটি আইটেম হল একটি liveChatMessage রিসোর্স।
activePollItem object
মেসেজে পোল ডেটা। প্রতিটি পোল হল liveChatMessage রিসোর্স যার ধরন হল pollEvent, যা একটি অ্যাক্টিভ পোলকে বোঝায়। প্রতিটি চ্যাটে শুধুমাত্র একটি পোল থাকতে পারে।

সমস্যা

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

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
forbidden (403) forbidden নির্দিষ্ট লাইভ চ্যাটের জন্য মেসেজ ফিরিয়ে আনার প্রয়োজনীয় অনুমতি আপনার কাছে নেই।
forbidden (403) liveChatDisabled নির্দিষ্ট ব্রডকাস্টের জন্য লাইভ চ্যাট চালু করা নেই।
forbidden (403) liveChatEnded উল্লেখ করা লাইভ চ্যাটটি আর লাইভ নেই।
notFound (404) liveChatNotFound আপনি যে লাইভ চ্যাট ফিরিয়ে আনার চেষ্টা করছেন সেটি খুঁজে পাওয়া যাচ্ছে না। অনুরোধের liveChatId প্যারামিটারের ভ্যালু সঠিক কিনা তা নিশ্চিত করুন।
rateLimitExceeded rateLimitExceeded আগের অনুরোধের পরে খুব দ্রুত এই অনুরোধটি পাঠানো হয়েছে। YouTube-এর রিফ্রেশ রেটের চেয়ে বেশি ঘন ঘন মেসেজ পাওয়ার জন্য API অনুরোধ পাঠানো হলে এই সমস্যা হয়, এর ফলে অযথা ব্যান্ডউইথ নষ্ট হয়।

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

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