LiveChatMessages: transition

YouTube पर लाइव चैट में मैसेज के स्टेटस में बदलाव करता है और नई स्थिति से जुड़ी प्रोसेस शुरू करता है. उदाहरण के लिए, जब किसी लाइव पोल की स्थिति को closed में बदला जाता है, तो YouTube उस मैसेज के पोल को बंद कर देता है. इस तरीके को कॉल करने से पहले, पक्का करें कि लाइव पोल मैसेज के लिए status प्रॉपर्टी की वैल्यू active हो.

अनुरोध

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

POST https://www.googleapis.com/youtube/v3/liveChatMessages/transition

अनुमति देना

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

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

पैरामीटर

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

पैरामीटर
ज़रूरी पैरामीटर
id	string id पैरामीटर उस मैसेज का यूनीक आईडी बताता है जिसका स्टेटस दूसरे स्टेटस में बदला जा रहा है.
status	enum status पैरामीटर से उस स्थिति की पहचान होती है जहां मैसेज बदला जा रहा है. किसी मैसेज को closed स्थिति में ले जाने के लिए, उस पोल के लिए status का active होना ज़रूरी है जिस पर वह मैसेज लागू होता है. आप सिर्फ़ closed पर ट्रांसफ़र कर सकते हैं. इसका मतलब है कि पोल बंद हो गया है.
वैकल्पिक पैरामीटर
part	string part पैरामीटर में, liveChatMessage संसाधन के ऐसे हिस्से तय किए जाते हैं जो एपीआई के रिस्पॉन्स में शामिल होते हैं. id, snippet, और authorDetails को वैल्यू के तौर पर इस्तेमाल किया जा सकता है. जवाब के मुख्य भाग में आखिरी पोल का नतीजा पाने के लिए, पैरामीटर की वैल्यू को snippet पर सेट करें.

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

इस तरीके का इस्तेमाल करते समय अनुरोध का मुख्य हिस्सा न भेजें.

जवाब

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

गड़बड़ियां

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

गड़बड़ी का टाइप	गड़बड़ी विवरण	ब्यौरा
forbidden (403)	forbidden	आपके पास इस मैसेज के स्टेटस को ट्रांसफ़र करने की ज़रूरी अनुमतियां नहीं हैं.
required (400)	idRequired	ज़रूरी id पैरामीटर को उस मैसेज की पहचान करनी चाहिए जिसकी स्थिति को ट्रांसफ़र करना है.
required (400)	statusRequired	एपीआई अनुरोध में, status पैरामीटर के लिए एक वैल्यू तय होनी चाहिए.
notFound (404)	liveChatMessagesNotFound	id पैरामीटर से तय किया गया मैसेज मौजूद नहीं है.
forbidden (403)	modificationNotAllowed	बताए गए liveChatMessage संसाधन की स्थिति को ट्रांसफ़र नहीं किया जा सकता. id पैरामीटर किसी ऐसे मैसेज की पहचान कर सकता है जिसकी स्थिति का ट्रांज़िशन नहीं किया जा सकता.

इसे आज़माएं!

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