परिचय

निम्न पृष्ठ में X API में शामिल Spaces एंडपॉइंट्स का वर्णन किया गया है। सामान्य रूप से Spaces के बारे में अधिक जानने के लिए, कृपया help.x.com पर जाएँ। 

Spaces, लाइव ऑडियो बातचीत के माध्यम से अभिव्यक्ति और सहभागिता की सुविधा देते हैं। Spaces एंडपॉइंट्स, Spaces के इर्द-गिर्द नई कार्यक्षमता बनाने के लिए टूल उपलब्ध कराते हैं। आप इन एंडपॉइंट्स का उपयोग लाइव या शेड्यूल किए गए Spaces को लुकअप करने के लिए कर सकते हैं, या ऐसे डिस्कवरी अनुभव बनाने के लिए कर सकते हैं जिनसे आपके उपयोगकर्ता अपनी रुचि के Spaces ढूँढ सकें।

हम आपको प्रोत्साहित करते हैं कि आप अपनी रचनात्मकता का उपयोग करके Spaces को हमारे बनाए गए तरीकों से आगे बढ़ाएँ। इन एंडपॉइंट्स के साथ, आप ऐसे अनुभव बना सकते हैं जो title में मौजूद keywords के आधार पर श्रोताओं को Spaces सुझाएँ, या ऐसे accounts को सामने लाएँ जो लाइव या आगामी Spaces host करते हैं और जिन्हें कोई उपयोगकर्ता follow करता है; आप Hosts को यह बेहतर समझने में भी मदद कर सकते हैं कि उनके Spaces कैसा प्रदर्शन कर रहे हैं और उन्हें अपनी audience के बारे में अधिक जानकारी मिल सके।

​

महत्वपूर्ण संसाधन

निम्नलिखित संसाधन आपको शुरुआत करने और Spaces एंडपॉइंट्स के साथ एकीकरण करने में मदद करेंगे:

• X API v2 का एक्सेस प्राप्त करना

• Spaces डेटा डिक्शनरी

• Spaces एंडपॉइंट पर अपना पहला अनुरोध करें

   

​

वर्तमान में क्या उपलब्ध है

Spaces लुकअप	एक Spaces ID से लुकअप एकाधिक Spaces IDs से लुकअप क्रिएटर ID से लुकअप टिकट खरीदने वाले उपयोगकर्ताओं की सूची का लुकअप
Spaces खोजें	कीवर्ड का उपयोग करके Spaces खोजें

​

Spaces के जीवनचक्र को समझना

X Developer Platform के अन्य संसाधनों के विपरीत, Spaces का एक निश्चित जीवनचक्र होता है। Spaces को उनकी निर्धारित शुरुआत की तारीख से 14 दिन पहले तक शेड्यूल किया जा सकता है, और समाप्त होने के बाद वे उपलब्ध नहीं रहते। कोई होस्ट पहले से शेड्यूल किए गए Space को शुरू होने से पहले कभी भी रद्द भी कर सकता है।

Spaces केवल उनके लाइव रहने तक ही उपलब्ध होते हैं; एक बार समाप्त हो जाने पर, उन्हें Spaces एंडपॉइंट्स का उपयोग करके फिर से प्राप्त नहीं किया जा सकेगा, और इस स्थिति को बताने के लिए एक त्रुटि संदेश लौटाया जाएगा।

जब आपका ऐप Spaces डेटा को संभालता है, तो सबसे अद्यतन जानकारी लौटाना और जो डेटा अब प्लेटफ़ॉर्म पर उपलब्ध नहीं है उसे हटाना आपकी ज़िम्मेदारी है। Spaces लुकअप एंडपॉइंट यह सुनिश्चित करने में आपकी मदद कर सकता है कि आप अपने उपयोगकर्ताओं की अपेक्षाओं और आशय का सम्मान करें।  

​

Spaces में भूमिकाएँ

ये एंडपॉइंट, X ऐप पर Spaces के काम करने के तरीके को दर्शाते हैं। Spaces में, X उपयोगकर्ताओं की तय भूमिकाएँ इस बात पर निर्भर हो सकती हैं कि वे किसी Space के साथ कैसे इंटरैक्ट करते हैं और उसमें कैसे भाग लेते हैं।  

​

Creator (या प्राथमिक होस्ट)

प्राथमिक Host वह उपयोगकर्ता होता है जिसने कोई Space बनाया हो, और वही उस Space का स्वामी भी होता है। वर्तमान में, Spaces में केवल एक ही Host हो सकता है, इसलिए प्राथमिक Host ही एकमात्र Host होगा। Spaces data dictionary में प्राथमिक Host की जानकारी creator_id फ़ील्ड में होती है, जिसे user object में विस्तारित किया जा सकता है।  

​

होस्ट

मुख्य होस्ट एक या अधिक उपयोगकर्ताओं को सह-होस्ट बना सकते हैं। Spaces डेटा डिक्शनरी में, ये होस्ट host_ids के रूप में दिखाई देंगे, जिन्हें उपयोगकर्ता ऑब्जेक्ट्स की सूची में विस्तारित किया जा सकता है। किसी Space की अवधि के दौरान होस्ट का निर्धारण बदल सकता है, और इन endpoints द्वारा लौटाया गया मेटाडेटा अनुरोध के समय की स्थिति को दर्शाएगा।

आपका ऐप creator_id मान की जांच करके मुख्य होस्ट की पहचान कर लेगा, और host_ids मानों की जांच करके यह पता लगा लेगा कि सह-होस्ट कौन हैं।  

​

वक्ता

वक्ता वे उपयोगकर्ता होते हैं जिन्हें Space में बोलने की अनुमति होती है। किसी भी समय शून्य या अधिक वक्ता मौजूद हो सकते हैं, और किसी Space में अधिकतम 10 वक्ता (Hosts सहित) हो सकते हैं। Space डेटा डिक्शनरी में, वक्ताओं को speaker_ids सूची में लौटाया जाता है, जिसे आप उपयोगकर्ता ऑब्जेक्ट की सूची में विस्तृत कर सकते हैं।  

​

श्रोता

श्रोता किसी Space को सुन सकता है, पहले से तय की गई प्रतिक्रियाओं का इस्तेमाल करके कभी भी प्रतिक्रिया दे सकता है, और वक्ता बनने का अनुरोध कर सकता है (जब Hosts, Space की सेटिंग्स में इसकी अनुमति देते हैं)। श्रोता की जानकारी केवल participant_count फ़ील्ड में प्रतिभागियों (Hosts सहित) की कुल संख्या के रूप में ही लौटाई जाएगी।