LiveChatBans: insert

একটি নির্দিষ্ট ব্যবহারকারীকে লাইভ চ্যাটে অংশগ্রহণ করা থেকে নিষিদ্ধ করে। API অনুরোধটি অবশ্যই চ্যানেলের মালিক বা নিষেধাজ্ঞার সাথে যুক্ত লাইভ চ্যাটের একজন মডারেটর দ্বারা অনুমোদিত হতে হবে।

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

অনুরোধ

HTTP অনুরোধ

POST https://www.googleapis.com/youtube/v3/liveChat/bans

অনুমোদন

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

ব্যাপ্তি
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

পরামিতি

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

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটার এই অপারেশন দুটি উদ্দেশ্য পরিবেশন করে. এটি সেই বৈশিষ্ট্যগুলিকে চিহ্নিত করে যা লেখার ক্রিয়াকলাপ সেট করবে সেইসাথে API প্রতিক্রিয়া যে বৈশিষ্ট্যগুলি প্রদান করে। প্যারামিটার মান snippet সেট করুন।

শরীরের অনুরোধ

অনুরোধের অংশে একটি লাইভচ্যাটব্যান সংস্থান সরবরাহ করুন। সেই সম্পদের জন্য:

  • এই বৈশিষ্ট্যগুলির জন্য আপনাকে অবশ্যই একটি মান নির্দিষ্ট করতে হবে:

    • snippet.liveChatId
    • snippet.type
    • snippet.bannedUserDetails.channelId

  • আপনি এই বৈশিষ্ট্যগুলির জন্য মান সেট করতে পারেন:

    • snippet.banDurationSeconds

প্রতিক্রিয়া

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি লাইভচ্যাটব্যান সংস্থান প্রদান করে।

ত্রুটি

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

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
forbidden (403) insufficientPermissions নির্দিষ্ট লাইভ চ্যাট থেকে একজন ব্যবহারকারীকে নিষিদ্ধ করার জন্য আপনার কাছে প্রয়োজনীয় অনুমতি নেই।
forbidden (403) liveChatBanInsertionNotAllowed নির্দিষ্ট নিষেধাজ্ঞা তৈরি করা যাবে না. অনুরোধটি চ্যাটের মালিক বা অন্য মডারেটরকে নিষিদ্ধ করার চেষ্টা করলে এই ত্রুটি ঘটতে পারে।
invalidValue (400) invalidChannelId নির্দিষ্ট চ্যানেল আইডি পাওয়া যাবে না।
invalidValue (400) invalidLiveChatId অনুরোধে উল্লেখিত snippet.liveChatId মানটি অবৈধ। আপনার সঠিক মান আছে কিনা তা নিশ্চিত করতে সংশ্লিষ্ট liveBroadcast রিসোর্স চেক করুন।
notFound (404) liveChatNotFound নির্দিষ্ট লাইভ চ্যাট পাওয়া যাবে না. আপনি snippet.liveChatId প্রপার্টি সঠিক মান সেট করছেন কিনা তা নিশ্চিত করতে সংশ্লিষ্ট liveBroadcast রিসোর্স চেক করুন।
notFound (404) liveChatUserNotFound আপনি যে লাইভ চ্যাট ব্যবহারকারীকে নিষিদ্ধ করার চেষ্টা করছেন তাকে খুঁজে পাওয়া যাবে না।
required (400) bannedUserChannelIdRequired অনুরোধের অংশে জমা দেওয়া liveChatBan সংস্থানকে অবশ্যই snippet.bannedUserDetails.channelId প্রপার্টির জন্য একটি মান উল্লেখ করতে হবে।
required (400) liveChatIdRequired অনুরোধের অংশে জমা দেওয়া liveChatBan সংস্থানটি অবশ্যই snippet.liveChatId সম্পত্তির জন্য একটি মান নির্দিষ্ট করতে হবে৷

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

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