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 ।
pageToken string
pageToken প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, nextPageToken সম্পত্তি অন্যান্য পৃষ্ঠাগুলি সনাক্ত করে যা পুনরুদ্ধার করা যেতে পারে।
profileImageSize unsigned integer
profileImageSize প্যারামিটার ব্যবহারকারীর প্রোফাইল ছবিগুলির আকার নির্দিষ্ট করে যা ফলাফল সেটে ফেরত দেওয়া উচিত। ছবিগুলো বর্গাকার। ডিফল্ট মান হল 88 , মানে ছবিগুলি হবে 88px by 88px৷ গ্রহণযোগ্য মান 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
বার্তায় ভোটের তথ্য। প্রতিটি পোল হল pollEvent টাইপ সহ একটি liveChatMessage সম্পদ, যা একটি সক্রিয় পোল প্রতিনিধিত্ব করে। প্রতি চ্যাটে শুধুমাত্র একটি পোল হতে পারে।

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

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

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

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