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

इस सेक्शन में दी गई गाइड में बताया गया है कि Google Chat ऐप्लिकेशन, Chat एपीआई को कैसे कॉल कर सकता है. इससे चैट ऐप्लिकेशन कई काम कर सकते हैं. जैसे, स्पेस बनाना, उसमें लोगों को जोड़ना, और Chat ऐप्लिकेशन के साथ इंटरैक्शन के इवेंट की अनुमति के बिना, मैसेज पोस्ट करना.

पुष्टि करना

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

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

एपीआई के संसाधन और तरीके

REST के संसाधन और तरीके, चैट स्पेस, स्पेस के सदस्यों, मैसेज, मैसेज पर प्रतिक्रियाएं, और मैसेज अटैचमेंट का एसिंक्रोनस ऐक्सेस देते हैं.

स्पेसेज़

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

spaces रिसॉर्स स्पेस के बारे में बताता है.

स्पेसेज़ में इन तरीकों का इस्तेमाल किया जा सकता है:

सदस्य

सदस्य ऐसे उपयोगकर्ता और चैट ऐप्लिकेशन होते हैं जो स्पेस में शामिल हुए हैं या जिन्हें स्पेस में शामिल होने का न्योता भेजा गया है.

spaces.members संसाधन किसी सदस्य के बारे में बताता है.

सदस्य इन तरीकों का इस्तेमाल कर सकते हैं:

  • स्पेस में उपयोगकर्ता या ऐप्लिकेशन को जोड़ने के लिए, सदस्यता बनाएं.
  • पैसे चुकाकर ली जाने वाली सदस्यता के बारे में जानकारी पाने के लिए, सदस्यता लें.
  • किसी स्पेस में, क्रम से लगाई गई और फ़िल्टर की जा सकने वाली सदस्यताओं की सूची देखने के लिए, सदस्यताओं की सूची बनाएं.
  • किसी स्पेस से उपयोगकर्ता या ऐप्लिकेशन को हटाने के लिए, सदस्यता मिटाना.
मैसेज

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

spaces.messages रिसॉर्स एक मैसेज दिखाता है.

Messages में इन तरीकों का इस्तेमाल किया जा सकता है:

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

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

spaces.messages.reactions के संसाधन से किसी प्रतिक्रिया का पता चलता है.

प्रतिक्रियाओं के साथ इन तरीकों का इस्तेमाल किया जा सकता है:

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

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

media रिसॉर्स, मैसेज से अटैच किए गए मीडिया को दिखाता है.

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

spaces.messages.attachments रिसॉर्स एक अटैचमेंट के बारे में बताता है. अटैचमेंट में किसी मैसेज के साथ अटैच किया गया मीडिया और उससे जुड़ा मेटाडेटा शामिल होता है.

मीडिया और अटैचमेंट में इन तरीकों का इस्तेमाल किया जा सकता है:

उपयोगकर्ता की समीक्षा की स्थिति (डेवलपर के लिए झलक)

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

users.spaces का रिसॉर्स, स्पेस में उपयोगकर्ता के पढ़े जाने की स्थिति के बारे में बताता है.

users.spaces.threads रिसॉर्स, मैसेज थ्रेड में उपयोगकर्ता के पढ़े गए की स्थिति को दिखाता है.

उपयोगकर्ता के रीड की स्थिति में इन तरीकों का इस्तेमाल किया जा सकता है:

खोज से जुड़े दस्तावेज़ का पता लगाना

इस एपीआई का खोज से जुड़ा दस्तावेज़, इस यूआरएल पर मिलेगा: