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
    • 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 बताई गई लाइव चैट नहीं मिली. इससे जुड़े liveBroadcast संसाधन की जांच करके पक्का करें कि आपने snippet.liveChatId प्रॉपर्टी को सही वैल्यू पर सेट किया है.
notFound (404) liveChatUserNotFound लाइव चैट में जिस दर्शक को बैन करना है वह नहीं मिला.
required (400) bannedUserChannelIdRequired अनुरोध के मुख्य हिस्से में सबमिट किए गए liveChatBan रिसॉर्स में, snippet.bannedUserDetails.channelId प्रॉपर्टी की वैल्यू दी जानी चाहिए.
required (400) liveChatIdRequired अनुरोध के मुख्य हिस्से में सबमिट किए गए liveChatBan रिसॉर्स में, snippet.liveChatId प्रॉपर्टी की वैल्यू होनी चाहिए.

इसे आज़माएं!

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