একটি YouTube লাইভ চ্যাট বার্তার স্থিতি স্থানান্তর করে এবং নতুন স্থিতির সাথে সম্পর্কিত যে কোনও প্রক্রিয়া শুরু করে৷ উদাহরণস্বরূপ, আপনি যখন একটি লাইভ পোলের স্থিতিকে closed
রূপান্তরিত করেন, তখন YouTube সেই বার্তাটির পোল শেষ করে। এই পদ্ধতিতে কল করার আগে, আপনাকে নিশ্চিত করতে হবে যে লাইভ পোল বার্তার জন্য status
প্রপার্টির মান active
।
অনুরোধ
HTTP অনুরোধ
POST https://www.googleapis.com/youtube/v3/liveChatMessages/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 কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।