LiveChatBans: insert

किसी उपयोगकर्ता को लाइव चैट में हिस्सा लेने से रोकें. एपीआई अनुरोध के लिए, चैनल के मालिक या पाबंदी से जुड़ी लाइव चैट के मॉडरेटर के पास अनुमति होनी चाहिए.

इस्तेमाल के सामान्य उदाहरण

अनुरोध

एचटीटीपी अनुरोध

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 पैरामीटर दो मकसद पूरे करता है. यह उन प्रॉपर्टी की पहचान करता है जिन्हें लिखने के दौरान सेट किया जाएगा. साथ ही, यह उन प्रॉपर्टी की भी पहचान करता है जो एपीआई से मिले रिस्पॉन्स से मिलती है. पैरामीटर वैल्यू को snippet पर सेट करें.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, liveChatBan संसाधन दें. इस संसाधन के लिए:

  • आपको इन प्रॉपर्टी के लिए एक वैल्यू तय करनी होगी:

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

  • इन प्रॉपर्टी के लिए वैल्यू सेट की जा सकती हैं:

    • snippet.banDurationSeconds

जवाब

अगर यह तरीका काम करता है, तो जवाब के मुख्य हिस्से में liveChatBan संसाधन दिखता है.

गड़बड़ियां

नीचे दी गई टेबल में गड़बड़ी के ऐसे मैसेज की पहचान की गई है जिन्हें एपीआई इस तरीके को कॉल करने पर जवाब दे सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी के मैसेज का दस्तावेज़ देखें.

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
forbidden (403) insufficientPermissions किसी खास लाइव चैट में उपयोगकर्ता पर पाबंदी लगाने के लिए, आपके पास ज़रूरी अनुमतियां नहीं हैं.
forbidden (403) liveChatBanInsertionNotAllowed दर्ज प्रतिबंध बनाया नहीं जा सकता. यह गड़बड़ी तब हो सकती है, जब अनुरोध करने पर चैट के मालिक या किसी दूसरे मॉडरेटर पर पाबंदी लगाने की कोशिश की गई हो.
invalidValue (400) invalidChannelId बताया गया चैनल आईडी नहीं मिला.
invalidValue (400) invalidLiveChatId अनुरोध में दर्ज snippet.liveChatId मान अमान्य है. संबंधित liveBroadcast संसाधन की जांच करके पक्का करें कि आपके पास सही वैल्यू है.
notFound (404) liveChatNotFound बताई गई लाइव चैट नहीं मिली. इससे जुड़े liveBroadcast संसाधन की जांच करके पक्का करें कि snippet.liveChatId प्रॉपर्टी को सही वैल्यू पर सेट किया जा रहा है.
notFound (404) liveChatUserNotFound लाइव चैट में शामिल जिस उपयोगकर्ता पर पाबंदी लगाई जा रही है उसे ढूंढा नहीं जा सका.
required (400) bannedUserChannelIdRequired अनुरोध के मुख्य हिस्से में सबमिट किए गए liveChatBan संसाधन को, snippet.bannedUserDetails.channelId प्रॉपर्टी के लिए एक वैल्यू तय करनी होगी.
required (400) liveChatIdRequired अनुरोध के मुख्य हिस्से में सबमिट किए गए liveChatBan संसाधन को, snippet.liveChatId प्रॉपर्टी के लिए एक वैल्यू तय करनी होगी.

इसे आज़माएं!

इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.