LiveChatBans: insert

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

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

अनुरोध

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

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

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप की अनुमति ज़रूरी है. प्रमाणीकरण और अनुमति के बारे में ज़्यादा जानने के लिए, OAuth 2.0 प्रमाणीकरण लागू करना लेख पढ़ें.

दायरा
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

पैरामीटर

यहां दी गई टेबल में, उन पैरामीटर की सूची दी गई है जिन्हें यह क्वेरी इस्तेमाल कर सकती है. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी पैरामीटर
part string
इस कार्रवाई में, part पैरामीटर दो मकसद पूरे करता है. यह उन प्रॉपर्टी की पहचान करता है जिन्हें राइट ऑपरेशन सेट करेगा. साथ ही, यह उन प्रॉपर्टी की भी पहचान करता है जिन्हें एपीआई से मिली जानकारी दिखाता है. पैरामीटर की वैल्यू को snippet पर सेट करें.

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

अनुरोध के मुख्य भाग में, liveChatBan संसाधन उपलब्ध कराएं. उस संसाधन के लिए:

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

    • snippet.liveChatId
    • snippet.type - इनमें से कोई एक विकल्प चुनें: permanent या temporary
    • snippet.bannedUserDetails.channelId

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

    • snippet.banDurationSeconds

जवाब

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

गड़बड़ियां

यहां दी गई टेबल में, गड़बड़ी के उन मैसेज की पहचान की गई है जो इस तरीके को कॉल करने पर, एपीआई दिखा सकता है. ज़्यादा जानकारी के लिए, YouTube Live Streaming 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 प्रॉपर्टी के लिए वैल्यू तय की जानी चाहिए.

इसे आज़माएं!

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