LiveChatMessages: insert

इससे लाइव चैट में कोई मैसेज या पोल जोड़ा जा सकता है.

कोटा पर असर: इस तरीके को कॉल करने पर, 20 यूनिट का कोटा खर्च होता है.

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

अनुरोध

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

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

अनुमति देना

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

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

पैरामीटर

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

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

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

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

  • snippet.liveChatId
  • snippet.type - इनमें से कोई एक विकल्प चुनें: textMessageEvent या pollEvent
  • अगर टाइप textMessageEvent है, तो snippet.textMessageDetails.messageText शामिल करें
  • अगर टाइप pollEvent है, तो snippet.pollDetails ऑब्जेक्ट को इस तरह से स्ट्रक्चर करें:
    • snippet.pollDetails.metadata.questionText (स्ट्रिंग): पोल का मुख्य सवाल.
    • snippet.pollDetails.metadata.options (Array): विकल्प ऑब्जेक्ट की सूची.
    • ज़रूरी शर्तें: आपको कम से कम दो और ज़्यादा से ज़्यादा चार आइटम शामिल करने होंगे.
    • क्रम: आइटम, सूची में दिए गए क्रम के हिसाब से दिखाए जाते हैं.
    • कलेक्शन में मौजूद हर ऑब्जेक्ट में ये शामिल होने चाहिए:
      • optionText (स्ट्रिंग): यह पोल के किसी विकल्प के लिए दिखाया गया टेक्स्ट होता है.

जवाब

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

गड़बड़ियां

यहां दी गई टेबल में, गड़बड़ी के उन मैसेज के बारे में बताया गया है जो इस तरीके को कॉल करने पर, एपीआई से मिल सकते हैं. ज़्यादा जानकारी के लिए, YouTube Live Streaming API - गड़बड़ियां देखें.

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
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 का इस्तेमाल करें. साथ ही, एपीआई अनुरोध और रिस्पॉन्स देखें.