लाइव चैट में मैसेज जोड़ता है.
इस्तेमाल के सामान्य उदाहरण
अनुरोध
एचटीटीपी अनुरोध
POST https://www.googleapis.com/youtube/v3/liveChat/messages
अनुमति देना
इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है (पुष्टि करने और अनुमति देने के बारे में ज़्यादा पढ़ें).
स्कोप |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
पैरामीटर
इस टेबल में वे पैरामीटर दिए गए हैं जो इस क्वेरी पर काम करते हैं. सूची में शामिल सभी पैरामीटर, क्वेरी पैरामीटर हैं.
पैरामीटर | ||
---|---|---|
ज़रूरी पैरामीटर | ||
part |
string part पैरामीटर से दो तरह के काम किए जाते हैं. यह उन प्रॉपर्टी की पहचान करता है जिन्हें लिखने के दौरान सेट किया जाएगा. साथ ही, यह उन प्रॉपर्टी की भी पहचान करता है जो एपीआई के रिस्पॉन्स में शामिल होंगी. पैरामीटर वैल्यू को snippet पर सेट करें. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, liveChatMessage संसाधन उपलब्ध कराएं. इस संसाधन के लिए, आपको इन प्रॉपर्टी के लिए वैल्यू तय करनी होंगी
snippet.liveChatId
snippet.type
-textMessageEvent
का इस्तेमाल करेंsnippet.textMessageDetails.messageText
जवाब
अगर यह तरीका काम करता है, तो जवाब के मुख्य हिस्से में liveChatMessage संसाधन दिखता है.
गड़बड़ियां
नीचे दी गई टेबल में गड़बड़ी के ऐसे मैसेज की पहचान की गई है जिन्हें एपीआई इस तरीके को कॉल करने पर जवाब दे सकता है. ज़्यादा जानकारी के लिए, गड़बड़ी के मैसेज का दस्तावेज़ देखें.
गड़बड़ी का टाइप | गड़बड़ी की जानकारी | कंपनी का ब्यौरा |
---|---|---|
forbidden (403) |
forbidden |
आपके पास यह मैसेज बनाने के लिए ज़रूरी अनुमतियां नहीं हैं. |
forbidden (403) |
liveChatDisabled |
इस लाइव चैट को मालिक ने बंद कर दिया है. इसका मतलब है कि चैट में मैसेज नहीं जोड़े जा सकते. |
forbidden (403) |
liveChatEnded |
बताई गई लाइव चैट अब लाइव नहीं है. |
invalidValue (400) |
messageTextInvalid |
संदेश टेक्स्ट (snippet.textMessageDetails.messageText ) मान्य नहीं है. |
notFound (404) |
liveChatNotFound |
एपीआई अनुरोध में पहचानी गई लाइव चैट मौजूद नहीं है. गड़बड़ी का यह मैसेज तब दिखता है, जब मालिक ने चैट मिटा दी हो. |
required (400) |
liveChatIdRequired |
liveChatMessage संसाधन में snippet.liveChatId प्रॉपर्टी के लिए कोई वैल्यू शामिल होनी चाहिए और उसके बारे में भी बताना चाहिए. |
required (400) |
messageTextRequired |
liveChatMessage संसाधन में snippet.textMessageDetails.messageText प्रॉपर्टी के लिए कोई वैल्यू शामिल होनी चाहिए और उसके बारे में भी बताना चाहिए. |
required (400) |
typeRequired |
liveChatMessage संसाधन में snippet.type प्रॉपर्टी के लिए कोई वैल्यू शामिल होनी चाहिए और उसके बारे में भी बताना चाहिए. पैरामीटर वैल्यू को text पर सेट करें |
required (400) |
preconditionCheckFailed |
पिन किया गया ऐक्टिव पोल पहले से मौजूद है. |
rateLimitExceeded |
rateLimitExceeded |
उपयोगकर्ता ने दी गई समयावधि में बहुत ज़्यादा चैट मैसेज पोस्ट किए हैं. |
इसे आज़माएं!
इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.