LiveChatMessages: transition

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

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

अनुरोध

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

POST https://www.googleapis.com/youtube/v3/liveChat/messages/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 का इस्तेमाल करें.