LiveChatMessages: insert

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

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

अनुरोध

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

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.options.questionText
    • snippet.pollDetails.metadata.options.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 का इस्तेमाल करें.