इस सेक्शन में दी गई गाइड में बताया गया है कि Google Chat ऐप्लिकेशन, Chat API को किस तरह कॉल कर सकता है. इसकी मदद से, Chat ऐप्लिकेशन कई तरह के काम कर सकते हैं. जैसे, स्पेस बनाना, उसमें लोगों को जोड़ना, और Chat ऐप्लिकेशन इंटरैक्शन इवेंट की अनुमति के बिना, मैसेज पोस्ट करना.
पुष्टि करना
एसिंक्रोनस तरीके से Chat API को कॉल करने के लिए, पुष्टि करना ज़रूरी है. Chat API के हर तरीके के लिए, उपयोगकर्ता की पुष्टि (उपयोगकर्ता की ओर से कार्रवाइयां करने या डेटा ऐक्सेस करने के लिए) या ऐप्लिकेशन की मदद से पुष्टि करने की सुविधा (कार्रवाइयां करने या चैट ऐप्लिकेशन के तौर पर डेटा ऐक्सेस करने के लिए) की ज़रूरत होती है. कुछ तरीकों में उपयोगकर्ता की पुष्टि और ऐप्लिकेशन की पुष्टि, दोनों की सुविधा काम करती है.
Chat में पुष्टि करने के बारे में ज़्यादा जानने के लिए, पुष्टि करने से जुड़ी खास जानकारी वाला लेख पढ़ें.
एपीआई के संसाधन और तरीके
REST के संसाधन और तरीके, चैट स्पेस, स्पेस के सदस्यों, मैसेज, मैसेज पर प्रतिक्रिया, और मैसेज अटैचमेंट को एसिंक्रोनस ऐक्सेस देते हैं.
- स्पेस
स्पेसेज़ ऐसी जगहें हैं जहां लोग और ऐप्लिकेशन, फ़ाइलों में बातचीत कर सकते हैं और उन्हें शेयर कर सकते हैं. स्पेस कई तरह के होते हैं. डायरेक्ट मैसेज (DM) में, दो उपयोगकर्ताओं या एक उपयोगकर्ता और Chat ऐप्लिकेशन के बीच 1:1 बातचीत होती है. ग्रुप चैट, तीन या उससे ज़्यादा उपयोगकर्ताओं और चैट ऐप्लिकेशन के बीच होने वाली बातचीत होती है. नाम वाले स्पेस वे स्थायी जगहें होती हैं जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और मिलकर काम करते हैं.
Spaceरिसॉर्स स्पेस को दिखाता है.Spaces में इन तरीकों का इस्तेमाल किया जा सकता है:
- एक स्पेस बनाएं, जहां लोग और ऐप्लिकेशन फ़ाइलों से बातचीत कर सकें और उन्हें शेयर कर सकें.
- स्पेस बनाने के लिए, स्पेस सेट अप करें. उसमें लोगों और चैट ऐप्लिकेशन को जोड़ें.
- किसी स्पेस की जानकारी देखने के लिए, स्पेस पाएं.
- स्पेस की पेज नंबर वाली और फ़िल्टर की जा सकने वाली सूची देखने के लिए, स्पेस की सूची बनाएं.
- किसी स्पेस के एट्रिब्यूट बदलने के लिए, स्पेस अपडेट करें, जैसे कि उपयोगकर्ता को दिखने वाला उसका डिसप्ले नेम, ब्यौरा, और दिशा-निर्देश.
- ज़रूरत न होने पर स्पेस को मिटाएं.
- दो उपयोगकर्ताओं के बीच DM या चैट ऐप्लिकेशन के बीच DM ढूंढने के लिए, डायरेक्ट मैसेज (DM) ढूंढें.
- सदस्य
सदस्य ऐसे उपयोगकर्ता और Chat ऐप्लिकेशन होते हैं जो किसी स्पेस में शामिल हो गए हैं या उन्हें स्पेस में शामिल होने का न्योता भेजा गया है.
Memberसंसाधन किसी सदस्य को दिखाता है.सदस्य इन तरीकों का इस्तेमाल करते हैं:
- स्पेस में उपयोगकर्ता या ऐप्लिकेशन जोड़ने के लिए, सदस्यता बनाएं.
- सदस्यता के बारे में जानकारी पाने के लिए, सदस्यता लें.
- सदस्यताओं की सूची बनाना: इससे आपको स्पेस में, अलग-अलग पेजों में बांटी गई सदस्यताओं की सूची दिखेगी.
- स्पेस से किसी उपयोगकर्ता या ऐप्लिकेशन को हटाने के लिए, सदस्यता मिटाएं.
- मैसेज
मैसेज में टेक्स्ट और कार्ड स्पेस में पोस्ट किए जाने वाले कम्यूनिकेशन शामिल होते हैं. मैसेज में फ़ाइलें अटैच की जा सकती हैं. लोग मैसेज पर इमोजी जोड़कर, उन पर प्रतिक्रिया दे सकते हैं.
Messageरिसॉर्स मैसेज दिखाता है.मैसेज में इन तरीकों का इस्तेमाल किया जा सकता है:
- टेक्स्ट या कार्ड मैसेज पोस्ट करने के लिए, मैसेज बनाएं. आपके पास मैसेज थ्रेड को शुरू करने या उसका जवाब देने का भी विकल्प है.
- किसी मैसेज के बारे में ज़्यादा जानकारी पाने के लिए, मैसेज पाएं, जैसे कि उसे कब भेजा गया था या उस पर क्या लिखा गया है.
- स्पेस में मैसेज की फ़िल्टर की जा सकने वाली सूची देखने के लिए, मैसेज की सूची बनाएं.
- मैसेज की विशेषताओं को बदलने के लिए, मैसेज अपडेट करें, जैसे कि उसमें क्या लिखा हो. किसी कार्ड मैसेज में या किसी कार्ड को मैसेज में भी जोड़ा जा सकता है.
- ज़रूरत न होने पर मैसेज मिटा दें.
- प्रतिक्रियाएं
प्रतिक्रियाएं उस इमोजी को दिखाती हैं जिसका इस्तेमाल लोग किसी मैसेज पर प्रतिक्रिया देने के लिए करते हैं. जैसे, 👍, ἁ, और 🚀.
Reactionरिसॉर्स किसी प्रतिक्रिया को दिखाता है.प्रतिक्रियाओं के लिए, इन तरीकों का इस्तेमाल किया जा सकता है:
- किसी मैसेज में इमोजी जोड़ने के लिए, कोई प्रतिक्रिया बनाएं.
- प्रतिक्रियाओं की सूची बनाएं ताकि किसी मैसेज के लिए फ़िल्टर की जा सकने वाली, पेज पर नंबर वाली सूची देखी जा सके.
- मैसेज से किसी इमोजी को हटाने के लिए कोई प्रतिक्रिया मिटाएं.
- मीडिया और अटैचमेंट
मीडिया, Google Chat पर अपलोड की गई फ़ाइल होती है. जैसे, इमेज, वीडियो, और दस्तावेज़.
Mediaसंसाधन, मैसेज से जुड़े मीडिया के बारे में बताता है.अटैचमेंट मैसेज में अटैच किए गए मीडिया (फ़ाइलें) के इंस्टेंस होते हैं.
Attachmentरिसॉर्स अटैचमेंट की जानकारी देता है. अटैचमेंट में किसी मैसेज से जुड़ा मीडिया और उससे जुड़ा मेटाडेटा शामिल होता है.मीडिया और अटैचमेंट में इन तरीकों का इस्तेमाल किया जा सकता है:
- मीडिया को Google Chat में अपलोड करने और फिर उसे मैसेज में अटैच करने के लिए, मीडिया को अटैचमेंट के तौर पर अपलोड करें.
- Google Chat से मीडिया को बाइनरी फ़ाइल के तौर पर डाउनलोड करने के लिए, मीडिया को अटैचमेंट के तौर पर डाउनलोड करें.
- किसी मैसेज अटैचमेंट के बारे में मेटाडेटा पाने के लिए, अटैचमेंट पाएं.
डिस्कवरी दस्तावेज़ ढूंढना
इस एपीआई का डिस्कवरी दस्तावेज़, इस यूआरएल पर मौजूद है: