इस सेक्शन में बताया गया है कि Google Chat ऐप्लिकेशन, Chat API को कैसे कॉल कर सकता है. इसकी मदद से, Chat ऐप्लिकेशन कई तरह के काम कर सकते हैं. जैसे, स्पेस बनाना, उसमें लोगों को जोड़ना, और Chat ऐप्लिकेशन से इंटरैक्शन इवेंट के प्रॉम्प्ट के बिना ही मैसेज पोस्ट करना.
पुष्टि करना
Chat API को एसिंक्रोनस रूप से कॉल करने के लिए पुष्टि करना ज़रूरी है. Chat API के हर तरीके के लिए, इनमें से कोई एक काम करना ज़रूरी है: उपयोगकर्ता की पुष्टि करना (उपयोगकर्ता की ओर से कार्रवाई करना या डेटा ऐक्सेस करना) या ऐप्लिकेशन की पुष्टि करना (चैट ऐप्लिकेशन के तौर पर कार्रवाइयां करने या डेटा ऐक्सेस करने के लिए). कुछ तरीकों में, उपयोगकर्ता की पुष्टि करने और ऐप्लिकेशन की पुष्टि करने, दोनों की सुविधा होती है.
Chat में पुष्टि करने के बारे में ज़्यादा जानने के लिए, पुष्टि करने की खास जानकारी देखें.
एपीआई से जुड़े संसाधन और तरीके
REST रिसॉर्स और तरीकों से, चैट स्पेस, स्पेस के सदस्यों, मैसेज, मैसेज प्रतिक्रियाओं, और मैसेज अटैचमेंट का एसिंक्रोनस ऐक्सेस मिलता है.
- स्पेस
स्पेस ऐसी जगहें हैं जहां लोग और ऐप्लिकेशन, आपस में बातचीत कर सकते हैं और फ़ाइलें शेयर कर सकते हैं. स्पेस कई तरह के होते हैं. डायरेक्ट मैसेज (DM), दो उपयोगकर्ताओं या किसी उपयोगकर्ता और Chat ऐप्लिकेशन के बीच 1:1 बातचीत होती हैं. ग्रुप चैट, तीन या उससे ज़्यादा उपयोगकर्ताओं और चैट ऐप्लिकेशन के बीच होने वाली बातचीत होती है. नाम वाले स्पेस ऐसी जगहें हैं जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और साथ मिलकर काम करते हैं.
spaces
रिसॉर्स, स्पेस के बारे में बताता है.स्पेसेज़ में ये तरीके काम करते हैं:
- कोई स्पेस बनाएं. यह एक ऐसी जगह है जहां लोग और ऐप्लिकेशन, आपस में बातचीत कर सकते हैं और फ़ाइलें शेयर कर सकते हैं.
- स्पेस बनाने के लिए, स्पेस सेट अप करें. इसके बाद, उसमें लोगों और चैट ऐप्लिकेशन को जोड़ें.
- किसी स्पेस की जानकारी देखने के लिए, स्पेस पाएं.
- स्पेस की पेज नंबर वाली और फ़िल्टर की जा सकने वाली सूची देखने के लिए, स्पेस की सूची बनाना.
- किसी स्पेस के एट्रिब्यूट बदलने के लिए, स्पेस को अपडेट करें. जैसे, लोगों को दिखने वाला डिसप्ले नेम, ब्यौरा, और दिशा-निर्देश.
- ज़रूरत न होने पर स्पेस को मिटाएं.
- दो उपयोगकर्ताओं के बीच DM या कॉल करने वाले चैट ऐप्लिकेशन के बीच DM दिखाने के लिए डायरेक्ट मैसेज (DM) ढूंढें.
- सदस्य
सदस्य ऐसे उपयोगकर्ता या Chat ऐप्लिकेशन होते हैं जो किसी स्पेस में शामिल हुए हैं या जिसे उसमें शामिल होने का न्योता भेजा गया है.
spaces.members
संसाधन किसी सदस्य के बारे में बताता है.सदस्य नीचे दिए गए तरीकों का इस्तेमाल करते हैं:
- स्पेस में किसी उपयोगकर्ता या ऐप्लिकेशन को जोड़ने के लिए, सदस्यता बनाएं.
- किसी सदस्यता से जुड़ी जानकारी देखने के लिए, सदस्यता लें.
- किसी स्पेस में सदस्यताओं की सूची देखने के लिए, सदस्यताओं की सूची बनाएं.
- सदस्यता से जुड़े एट्रिब्यूट बदलने के लिए, सदस्यता अपडेट करें. जैसे, स्पेस के सदस्य को स्पेस मैनेजर बनाना या स्पेस मैनेजर को स्पेस का सदस्य बनाना.
- स्पेस से किसी उपयोगकर्ता या ऐप्लिकेशन को हटाने के लिए, सदस्यता मिटाएं.
- मैसेज
मैसेज में, स्पेस में पोस्ट किए गए टेक्स्ट और कार्ड की जानकारी शामिल होती है. Messages में फ़ाइलें अटैच की जा सकती हैं. लोग मैसेज पर इमोजी जोड़कर, उन पर प्रतिक्रिया दे सकते हैं.
spaces.messages
रिसॉर्स, मैसेज को दिखाता है.Messages में ये तरीके काम करते हैं:
- टेक्स्ट या कार्ड मैसेज पोस्ट करने के लिए, मैसेज बनाएं. इसके अलावा, किसी मैसेज थ्रेड को शुरू किया जा सकता है या उसका जवाब दिया जा सकता है.
- किसी मैसेज के बारे में जानकारी पाने के लिए मैसेज पाएं. जैसे, उसे कब भेजा गया था या उसमें क्या कहा गया था.
- किसी स्पेस में मैसेज की अलग-अलग कैटगरी वाली और फ़िल्टर की जा सकने वाली सूची देखने के लिए, मैसेज की सूची बनाएं.
- मैसेज के एट्रिब्यूट (जैसे, मैसेज में क्या बदलाव होना चाहिए) में बदलाव करने के लिए, मैसेज अपडेट करें. आपके पास किसी कार्ड मैसेज में टेक्स्ट या किसी टेक्स्ट मैसेज में कार्ड जोड़ने का विकल्प भी है.
- ज़रूरत न होने पर मैसेज मिटाएं.
- प्रतिक्रियाएं
प्रतिक्रियाओं से उन इमोजी का पता चलता है जिनका इस्तेमाल लोग किसी मैसेज पर प्रतिक्रिया देने के लिए करते हैं. जैसे, 👍, 👍, और ↓.
प्रतिक्रिया को दिखाने के लिए,
spaces.messages.reactions
का संसाधन दिखाया जाता है.प्रतिक्रियाओं में ये तरीके काम करते हैं:
- किसी मैसेज में इमोजी जोड़ने के लिए, प्रतिक्रिया बनाएं.
- किसी मैसेज पर की गई प्रतिक्रियाओं की सूची देखने के लिए, प्रतिक्रियाओं की सूची बनाएं.
- मैसेज से इमोजी हटाने के लिए, किसी प्रतिक्रिया को मिटाएं.
- मीडिया और अटैचमेंट
मीडिया फ़ॉर्मैट, Google Chat पर अपलोड की गई फ़ाइल को दिखाता है, जैसे कि इमेज, वीडियो, और दस्तावेज़.
media
संसाधन, मैसेज में अटैच किए गए मीडिया के बारे में बताता है.अटैचमेंट, मैसेज में अटैच किए गए मीडिया (फ़ाइलें) के इंस्टेंस होते हैं.
spaces.messages.attachments
संसाधन एक अटैचमेंट को दिखाता है. अटैचमेंट में मैसेज के साथ जुड़ा मीडिया और उससे जुड़ा मेटाडेटा शामिल होता है.मीडिया और अटैचमेंट में इन तरीकों का इस्तेमाल किया जा सकता है:
- Google Chat में मीडिया अपलोड करने के लिए, मीडिया को अटैचमेंट के तौर पर अपलोड करें. इसके बाद, उसे किसी मैसेज में अटैच करें.
- Google Chat से मीडिया को बाइनरी फ़ाइल के तौर पर डाउनलोड करने के लिए, मीडिया को अटैचमेंट के तौर पर डाउनलोड करें.
- किसी मैसेज अटैचमेंट का मेटाडेटा वापस पाने के लिए अटैचमेंट पाएं.
- अंतरिक्ष इवेंट
स्पेस इवेंट, स्पेस या उसमें बच्चों के संसाधनों में हुए बदलावों के बारे में बताते हैं. इनमें सदस्य, मैसेज, और प्रतिक्रियाएं भी शामिल हैं.
spaces.spaceEvent
संसाधन, स्पेस इवेंट के बारे में बताता है.स्पेस इवेंट में ये तरीके काम करते हैं:
- किसी स्पेस में होने वाले इवेंट की जानकारी पाने के लिए, स्पेस में होने वाला इवेंट पाएं.
- किसी स्पेस में होने वाले इवेंट की सूची पाने के लिए, स्पेस में होने वाले इवेंट की सूची बनाना.
- उपयोगकर्ता की पढ़ी गई स्थितियां
उपयोगकर्ता के पढ़े जाने की स्थिति, सिंगलटन रिसॉर्स होते हैं. इनसे Google Chat के स्पेस या मैसेज थ्रेड में, बताए गए उपयोगकर्ता के आखिरी बार पढ़े गए मैसेज की जानकारी मिलती है.
users.spaces
संसाधन, स्पेस में उपयोगकर्ता के पढ़ने की स्थिति के बारे में बताता है.users.spaces.threads
संसाधन किसी मैसेज थ्रेड में उपयोगकर्ता की पढ़ने की स्थिति दिखाता है.उपयोगकर्ता की ओर से पढ़े जाने वाले स्टेटस की जानकारी के लिए, ये तरीके इस्तेमाल किए जा सकते हैं:
- किसी स्पेस में उपयोगकर्ता के पढ़े जाने की स्थिति की जानकारी देने के लिए, स्पेस को पढ़े जाने की स्थिति की जानकारी पाएं.
- किसी स्पेस में उपयोगकर्ता की पढ़ने की स्थिति अपडेट करने के लिए, स्पेस में पढ़े जाने की स्थिति अपडेट करें.
- थ्रेड के पढ़े जाने की स्थिति की जानकारी पाएं. इससे आपको थ्रेड में उपयोगकर्ता की पढ़ने की स्थिति के बारे में जानकारी मिलेगी.