LiveChatMessages: transition

YouTube লাইভ চ্যাট মেসেজের স্ট্যাটাস পরিবর্তন করে এবং নতুন স্ট্যাটাসের সাথে সম্পর্কিত যেকোনও প্রসেস শুরু করে। যেমন, আপনি কোনও লাইভ পোলের স্ট্যাটাস closed-এ পরিবর্তন করলে, YouTube সেই মেসেজের পোল শেষ করে দেয়। এই পদ্ধতি কল করার আগে, আপনাকে কনফার্ম করতে হবে যে লাইভ পোল মেসেজের জন্য status প্রপার্টির ভ্যালু হল active।

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

অনুরোধ করুন

HTTP অনুরোধ

POST https://www.googleapis.com/youtube/v3/liveChat/messages/transition

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির সাথে অনুমোদন প্রয়োজন (যাচাইকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন)।

সুযোগ
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

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

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

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
id string
id প্যারামিটারটি মেসেজের অনন্য আইডি নির্দিষ্ট করে যা অন্য স্ট্যাটাসে পরিবর্তিত হচ্ছে।
status enum
status প্যারামিটারটি সেই স্ট্যাটাস শনাক্ত করে যেটিতে মেসেজটি পরিবর্তন হচ্ছে। closed স্ট্যাটাসে মেসেজ ট্রানজিশন করতে, মেসেজ যে পোলের সাথে যুক্ত সেটির status অবশ্যই active হতে হবে।

আপনি শুধুমাত্র closed-এ ট্রানজিট করতে পারবেন, এর অর্থ হল পোল বন্ধ হয়ে গেছে।
ঐচ্ছিক প্যারামিটার
part string
part প্যারামিটার liveChatMessage রিসোর্স পার্ট নির্দিষ্ট করে যা API রেসপন্সে অন্তর্ভুক্ত থাকবে। সাপোর্ট করা ভ্যালু হল id, snippet এবং authorDetails।

রেসপন্স বডিতে পোল সংক্রান্ত চূড়ান্ত ফলাফল পেতে প্যারামিটার ভ্যালু snippet হিসেবে সেট করুন।

অনুরোধের বডি

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

রেসপন্স

সফল হলে, এই পদ্ধতি রেসপন্স বডিতে liveChatMessages রিসোর্স ফিরিয়ে দেয়।

সমস্যা

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

সমস্যার ধরন সমস্যার বিবরণ বিবরণ
forbidden (403) forbidden নির্দিষ্ট মেসেজের স্ট্যাটাস পরিবর্তন করার জন্য প্রয়োজনীয় অনুমতি আপনার কাছে নেই।
required (400) idRequired প্রয়োজনীয় id প্যারামিটারকে অবশ্যই সেই মেসেজ শনাক্ত করতে হবে যার স্ট্যাটাস আপনি পরিবর্তন করতে চান।
required (400) statusRequired API অনুরোধে অবশ্যই status প্যারামিটারের জন্য একটি মান উল্লেখ করতে হবে।
notFound (404) liveChatMessagesNotFound id প্যারামিটার দ্বারা নির্দিষ্ট করা মেসেজটি নেই।
forbidden (403) modificationNotAllowed নির্দিষ্ট করা liveChatMessage রিসোর্সের স্ট্যাটাস পরিবর্তন করা যাবে না। id প্যারামিটার এমন একটি মেসেজ শনাক্ত করতে পারে যার স্ট্যাটাস পরিবর্তন করা যাবে না।

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

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