Google Chat API की खास जानकारी

इस सेक्शन में बताया गया है कि Google Chat ऐप्लिकेशन, Chat API को कैसे कॉल कर सकता है. इसकी मदद से, Chat ऐप्लिकेशन स्पेस बना सकते हैं, उसमें लोगों को जोड़ सकते हैं, और मैसेज पोस्ट कर सकते हैं.

पुष्टि करना

Chat API को कॉल करने के लिए, पुष्टि करना ज़रूरी है. Chat API के हर तरीके के लिए, उपयोगकर्ता की पुष्टि (किसी उपयोगकर्ता की ओर से कार्रवाइयां करने या डेटा ऐक्सेस करने के लिए) या ऐप्लिकेशन की पुष्टि (Chat ऐप्लिकेशन के तौर पर कार्रवाइयां करने या डेटा ऐक्सेस करने के लिए) करना ज़रूरी है. कुछ तरीकों से, उपयोगकर्ता की पुष्टि और ऐप्लिकेशन की पुष्टि, दोनों की जा सकती है.

Chat में पुष्टि करने के बारे में ज़्यादा जानने के लिए, पुष्टि करने की खास जानकारी देखें.

क्लाइंट लाइब्रेरी

ज़्यादातर डेवलपर के लिए, Google Chat API को कॉल करने का सुझाया गया तरीका यह है कि वे अपनी पसंदीदा भाषा, जैसे कि Python, Java या Node.js के लिए, आधिकारिक तौर पर काम करने वाली क्लाउड क्लाइंट लाइब्रेरी का इस्तेमाल करें.

अगर Google Apps Script का इस्तेमाल करके कोडिंग की जा रही है, तो क्लाइंट लाइब्रेरी इंस्टॉल करने के बजाय, Chat की बेहतर सेवा का इस्तेमाल करें.

Google Chat API के कॉन्सेप्ट

gRPC सेवाएं या REST रिसॉर्स और तरीके, Chat के स्पेस, स्पेस के सदस्यों, मैसेज, मैसेज पर मिले प्रतिक्रियाओं, मैसेज के अटैचमेंट, स्पेस के इवेंट, और उपयोगकर्ता के मैसेज पढ़ने की स्थिति का ऐक्सेस देते हैं.

स्पेस

स्पेसेज़ ऐसी जगहें हैं जहां लोग और ऐप्लिकेशन बातचीत कर सकते हैं और फ़ाइलें शेयर कर सकते हैं. स्पेस कई तरह के होते हैं. डायरेक्ट मैसेज (डीएम), दो उपयोगकर्ताओं या किसी उपयोगकर्ता और Chat ऐप्लिकेशन के बीच की 1:1 बातचीत होती है. ग्रुप चैट, तीन या उससे ज़्यादा उपयोगकर्ताओं और Chat ऐप्लिकेशन के बीच की बातचीत होती है. नाम वाले स्पेस, हमेशा मौजूद रहते हैं. इनमें लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और साथ मिलकर काम करते हैं.

संसाधन का रेफ़रंस:

• आरपीसी रेफ़रंस
• REST का रेफ़रंस

इस्तेमाल के उदाहरण के लिए, यह देखें:

• स्पेस बनाना
• स्पेस सेट अप करना
• स्पेस बनाना
• स्पेस की सूची
• स्पेस अपडेट करना
• स्पेस मिटाना
• डायरेक्ट मैसेज (डीएम) ढूंढना

सदस्य

सदस्य वे उपयोगकर्ता और Chat ऐप्लिकेशन होते हैं जिन्होंने स्पेस में शामिल होने का न्योता स्वीकार किया है या जिन्हें न्योता भेजा गया है.

संसाधन का रेफ़रंस:

• आरपीसी रेफ़रंस
• REST का रेफ़रंस

इस्तेमाल के उदाहरण के लिए, ये देखें:

• सदस्यता बनाना
• सदस्यता लेना
• पैसे चुकाकर ली जाने वाली सदस्यताओं की सूची
• पैसे चुकाकर ली गई सदस्यता को अपडेट करना
• सदस्यता मिटाना

मैसेज

मैसेज में, स्पेस में पोस्ट किए गए टेक्स्ट और कार्ड शामिल होते हैं. मैसेज में फ़ाइलें अटैच की जा सकती हैं. लोग मैसेज पर प्रतिक्रिया देने के लिए, उनमें इमोजी जोड़ सकते हैं.

संसाधन का रेफ़रंस:

• आरपीसी रेफ़रंस
• REST का रेफ़रंस

इस्तेमाल के उदाहरण के लिए, यह देखें:

• मैसेज बनाना
• मैसेज पाना
• मैसेज की सूची देखना
• मैसेज अपडेट करना
• मैसेज मिटाना

प्रतिक्रियाएं

प्रतिक्रियाएं, इमोजी के तौर पर दिखती हैं. इन्हें लोग किसी मैसेज पर प्रतिक्रिया देने के लिए इस्तेमाल करते हैं. जैसे, 👍, 🚲, और 🌞.

संसाधन का रेफ़रंस:

• आरपीसी रेफ़रंस
• REST का रेफ़रंस

इस्तेमाल के उदाहरण के लिए, ये देखें:

• प्रतिक्रिया देना
• प्रतिक्रियाओं की सूची देखना
• प्रतिक्रिया मिटाना

पसंद के मुताबिक बनाए गए इमोजी (डेवलपर के लिए झलक)

पसंद के मुताबिक बनाए गए इमोजी, Google Chat में संगठन के लिए बनाए गए और शेयर किए गए इमोजी होते हैं. पसंद के मुताबिक बनाए गए इमोजी को मैसेज के कॉन्टेंट में शामिल किया जा सकता है या किसी मैसेज पर प्रतिक्रिया देने के लिए इस्तेमाल किया जा सकता है.

संसाधन का रेफ़रंस:

• आरपीसी रेफ़रंस
• REST का रेफ़रंस

मीडिया और अटैचमेंट

मीडिया से, Google Chat पर अपलोड की गई फ़ाइल के बारे में पता चलता है. जैसे, इमेज, वीडियो, और दस्तावेज़.

मीडिया रिसॉर्स का रेफ़रंस (RPC में उपलब्ध नहीं है):

• REST का रेफ़रंस

अटैचमेंट, मैसेज में अटैच किए गए मीडिया (फ़ाइलों) के इंस्टेंस होते हैं.

संसाधन का रेफ़रंस:

• आरपीसी रेफ़रंस
• REST का रेफ़रंस

इस्तेमाल के उदाहरण के लिए, यह देखें:

• मीडिया को अटैचमेंट के तौर पर अपलोड करना
• मीडिया को अटैचमेंट के तौर पर डाउनलोड करना
• अटैचमेंट पाना

स्पेस में होने वाले इवेंट

स्पेस इवेंट, स्पेस या उसके चाइल्ड रिसॉर्स में हुए बदलावों के बारे में बताते हैं. इनमें स्पेस के सदस्य, मैसेज, और प्रतिक्रियाएं शामिल हैं.

संसाधन का रेफ़रंस:

• आरपीसी रेफ़रंस
• REST का रेफ़रंस

इस्तेमाल के उदाहरण के लिए, यह देखें:

• स्पेस में मौजूद मैसेज पढ़े जाने की स्थिति देखना
• स्पेस में मौजूद फ़ाइलों को पढ़े जाने की स्थिति अपडेट करना
• थ्रेड के पढ़े जाने की स्थिति जानना

उपयोगकर्ता के पढ़ने की स्थितियां

उपयोगकर्ता के मैसेज पढ़ने की स्थिति, सिंगलटन रिसॉर्स होते हैं. इनसे, Google Chat के स्पेस या मैसेज थ्रेड में किसी उपयोगकर्ता के आखिरी पढ़े गए मैसेज की जानकारी मिलती है.

स्पेस में मौजूद फ़ाइलों को पढ़ने की स्थिति से जुड़े संसाधन का रेफ़रंस:

• आरपीसी रेफ़रंस
• REST का रेफ़रंस

थ्रेड पढ़ने की स्थिति के संसाधन का रेफ़रंस:

• आरपीसी रेफ़रंस
• REST का रेफ़रंस

इस्तेमाल के उदाहरण के लिए, ये देखें:

• स्पेस में मौजूद मैसेज पढ़े जाने की स्थिति देखना
• स्पेस में मौजूद फ़ाइलों को पढ़े जाने की स्थिति अपडेट करना
• थ्रेड के पढ़े जाने की स्थिति जानना

उपयोगकर्ता के स्पेस की सूचना सेटिंग (डेवलपर के लिए झलक)

स्पेस में उपयोगकर्ता की सूचना सेटिंग, सिंगलटन रिसॉर्स होते हैं. ये Google Chat के स्पेस में, उपयोगकर्ता की सूचना सेटिंग के बारे में बताते हैं.

संसाधन का रेफ़रंस:

• आरपीसी रेफ़रंस
• REST का रेफ़रंस

मिलते-जुलते विषय

• Chat API का इस्तेमाल शुरू करने के लिए, Google Chat ऐप्लिकेशन के सैंपल एक्सप्लोर करें.

Chat API को कॉल करने के अलावा, Chat ऐप्लिकेशन ये काम भी कर सकते हैं:

• Chat ऐप्लिकेशन के इंटरैक्शन इवेंट पाना और उनका जवाब देना. जैसे, Google Chat ऐप्लिकेशन पर भेजे गए मैसेज, रीयल टाइम में.
• Chat में कोई गतिविधि या बदलाव होने पर कार्रवाई करने या जवाब देने के लिए, Google Chat इवेंट की सदस्यता लें. जैसे, नए मैसेज और सदस्यता में बदलाव.