LiveChatMessages: insert

लाइव चैट में मैसेज जोड़ता है. फ़िलहाल, एपीआई में सिर्फ़ मैसेज डाले जा सकते हैं.

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

अनुरोध

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

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 एपीआई अनुरोध में पहचानी गई लाइव चैट मौजूद नहीं है. गड़बड़ी का यह मैसेज तब दिखता है, जब मालिक ने चैट मिटा दी हो.
rateLimitExceeded rateLimitExceeded उपयोगकर्ता ने दी गई समयावधि में बहुत ज़्यादा चैट मैसेज पोस्ट किए हैं.
required (400) liveChatIdRequired liveChatMessage संसाधन में snippet.liveChatId प्रॉपर्टी के लिए कोई वैल्यू शामिल होनी चाहिए और उसके बारे में भी बताना चाहिए.
required (400) messageTextRequired liveChatMessage संसाधन में snippet.textMessageDetails.messageText प्रॉपर्टी के लिए कोई वैल्यू शामिल होनी चाहिए और उसके बारे में भी बताना चाहिए.
required (400) typeRequired liveChatMessage संसाधन में snippet.type प्रॉपर्टी के लिए कोई वैल्यू शामिल होनी चाहिए और उसके बारे में भी बताना चाहिए. पैरामीटर वैल्यू को text पर सेट करें

इसे आज़माएं!

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