इस पेज पर, Google Chat के लिए ऐड-ऑन के यूज़र इंटरफ़ेस (यूआई) बनाने के तरीके के बारे में खास जानकारी दी गई है.
Chat ऐप्लिकेशन के लिए इंटरफ़ेस बनाने के लिए, इन ऐड-ऑन कॉम्पोनेंट का इस्तेमाल किया जाता है:
- ट्रिगर: Google Chat के उपयोगकर्ता, Chat ऐप्लिकेशन को इन तरीकों से शुरू कर सकते हैं. जैसे, उसे किसी स्पेस में जोड़कर या उसे मैसेज भेजकर.
- इवेंट ऑब्जेक्ट: यह वह डेटा होता है जो चैट ऐप्लिकेशन को ट्रिगर या यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन से मिलता है.
- कार्रवाइयां: Chat ऐप्लिकेशन, इंटरैक्शन का जवाब देने के लिए इन तरीकों का इस्तेमाल कर सकते हैं. जैसे, मैसेज भेजना या कार्ड पर आधारित यूज़र इंटरफ़ेस दिखाना.
चैट ऐप्लिकेशन, इन इंटरफ़ेस में कार्ड बना सकते हैं और उन्हें दिखा सकते हैं:
- मैसेज में टेक्स्ट, स्टैटिक या इंटरैक्टिव कार्ड, और बटन शामिल हो सकते हैं.
- डायलॉग, कार्ड होते हैं. ये नई विंडो में खुलते हैं और आम तौर पर, उपयोगकर्ताओं से जानकारी सबमिट करने के लिए कहते हैं.
- लिंक की झलक. ये कार्ड होते हैं, जो किसी बाहरी सेवा के बारे में जानकारी की झलक दिखाते हैं.
ट्रिगर
इस सेक्शन में उन ट्रिगर के बारे में बताया गया है जिनका इस्तेमाल Google Workspace ऐड-ऑन, Chat में करते हैं.
ट्रिगर, Chat ऐप्लिकेशन को चालू करने के खास तरीके होते हैं. उपयोगकर्ता, Chat के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, इन तरीकों से ऐप्लिकेशन को चालू करते हैं. जैसे, @mention या ऐप्लिकेशन के कमांड इस्तेमाल करना.
इस टेबल में, Chat ट्रिगर, उनकी जानकारी, और Chat ऐप्लिकेशन के जवाब देने के तरीके के बारे में बताया गया है:
| ट्रिगर | ब्यौरा | सामान्य जवाब |
|---|---|---|
| स्पेस में जोड़ा गया |
कोई उपयोगकर्ता किसी स्पेस में Chat ऐप्लिकेशन जोड़ता है या कोई Google Workspace एडमिन, अपने संगठन के उपयोगकर्ताओं के लिए डायरेक्ट मैसेज वाले स्पेस में Chat ऐप्लिकेशन इंस्टॉल करता है. एडमिन के इंस्टॉल किए गए Chat ऐप्लिकेशन के बारे में जानने के लिए, Google Workspace एडमिन सहायता केंद्र के दस्तावेज़ में अपने डोमेन में, Google Workspace Marketplace पर मौजूद ऐप्लिकेशन इंस्टॉल करना लेख पढ़ें. |
Chat ऐप्लिकेशन, शामिल होने का मैसेज भेजता है. इसमें बताया जाता है कि यह क्या करता है और स्पेस में मौजूद लोग इससे कैसे इंटरैक्ट कर सकते हैं. |
| मैसेज |
कोई उपयोगकर्ता, Chat ऐप्लिकेशन में मैसेज के साथ इन तरीकों से इंटरैक्ट करता है:
|
Chat ऐप्लिकेशन, मैसेज के कॉन्टेंट के आधार पर जवाब देता है. उदाहरण के लिए, Chat ऐप्लिकेशन, स्लैश कमांड /about का जवाब ऐसे मैसेज से देता है जिसमें Chat ऐप्लिकेशन के ज़रिए किए जा सकने वाले टास्क के बारे में बताया गया हो.
|
| स्पेस से हटाया गया |
जब कोई उपयोगकर्ता किसी स्पेस से Chat ऐप्लिकेशन को हटा देता है या Google Workspace एडमिन, अपने संगठन के किसी उपयोगकर्ता के लिए Chat ऐप्लिकेशन को अनइंस्टॉल कर देता है. उपयोगकर्ता, उन Chat ऐप्लिकेशन को नहीं हटा सकते जिन्हें उनके एडमिन ने इंस्टॉल किया था. अगर किसी उपयोगकर्ता ने पहले से Chat ऐप्लिकेशन इंस्टॉल किया है, तो Google Workspace एडमिन के अनइंस्टॉल करने की कोशिश करने के बावजूद, Chat ऐप्लिकेशन इंस्टॉल रहता है. |
Chat ऐप्लिकेशन, स्पेस के लिए कॉन्फ़िगर की गई सभी सूचनाएं हटा देता है. जैसे, वेबुक को मिटाना. साथ ही, यह ऐप्लिकेशन इंटरनल स्टोरेज को भी खाली कर देता है. चैट ऐप्लिकेशन, इस ट्रिगर के जवाब में मैसेज नहीं भेज सकते, क्योंकि वे अब स्पेस के सदस्य नहीं हैं. |
| ऐप्लिकेशन कमांड |
कोई उपयोगकर्ता Chat ऐप्लिकेशन की कमांड का इस्तेमाल करता है. |
Chat ऐप्लिकेशन, कमांड का जवाब देता है. उदाहरण के लिए, मैसेज के साथ जवाब देता है या कोई डायलॉग बॉक्स खोलता है. |
Google Workspace के अन्य ऐड-ऑन के उलट, आपको Google Chat API का इस्तेमाल करके, इन ट्रिगर के लिए किसी भी कॉलबैक फ़ंक्शन को कॉन्फ़िगर करना होगा. निर्देशों के लिए, Google Chat ऐप्लिकेशन को कॉन्फ़िगर करना लेख पढ़ें.
ट्रिगर का जवाब देने के लिए, यहां दी गई गाइड देखें:
- Google Chat में मैसेज भेजना
- इंटरैक्टिव डायलॉग बॉक्स खोलना
- Google Chat में भेजे गए मैसेज में मौजूद लिंक की झलक देखना
इवेंट ऑब्जेक्ट
जब Chat ट्रिगर चालू होता है या जब Chat उपयोगकर्ता, Chat ऐप्लिकेशन के यूज़र इंटरफ़ेस (जैसे, किसी बटन पर क्लिक करना) से इंटरैक्ट करते हैं, तब Chat ऐप्लिकेशन को इवेंट ऑब्जेक्ट मिलते हैं. इवेंट ऑब्जेक्ट में, इंटरैक्शन के बारे में डेटा होता है. Chat ऐप्लिकेशन, इस डेटा का इस्तेमाल जवाब देने या यूज़र इंटरफ़ेस (यूआई) को अपडेट करने के लिए कर सकता है.
इवेंट ऑब्जेक्ट मैनेज करने के बारे में जानने के लिए, यहां दी गई गाइड देखें:
- Google Chat में मैसेज भेजना
- इंटरैक्टिव डायलॉग बॉक्स खोलना
- Google Chat में भेजे गए मैसेज में मौजूद लिंक की झलक देखना
Chat और Google Workspace के अन्य ऐप्लिकेशन में ऐड-ऑन इवेंट ऑब्जेक्ट के बारे में जानने के लिए, इवेंट ऑब्जेक्ट देखें.
चैट से जुड़ी कार्रवाइयां
इस सेक्शन में बताया गया है कि Chat ऐप्लिकेशन, उपयोगकर्ता के इंटरैक्शन का जवाब देने के लिए ऐड-ऑन की कार्रवाइयों का इस्तेमाल कैसे कर सकते हैं.
ऐड-ऑन की मदद से की जाने वाली कार्रवाई का जवाब देने के लिए, चैट ऐप्लिकेशन को 30 सेकंड के अंदर जवाब देना होगा. साथ ही, जवाब को उस स्पेस में पोस्ट करना होगा जहां बातचीत हुई थी. इसके अलावा, Chat ऐप्लिकेशन को जवाब देने के लिए, पुष्टि की सुविधा सेट अप करनी होगी और Google Chat API को कॉल करना होगा.
चैट ऐप्लिकेशन, इंटरैक्शन को कई तरह से मैनेज कर सकते हैं और उनके जवाब दे सकते हैं. ज़्यादातर मामलों में, Chat ऐप्लिकेशन मैसेज के ज़रिए जवाब देते हैं. चैट ऐप्लिकेशन, डेटा सोर्स से कुछ जानकारी भी खोज सकते हैं. साथ ही, इवेंट ऑब्जेक्ट की जानकारी रिकॉर्ड कर सकते हैं या कुछ और भी कर सकते हैं. प्रोसेसिंग का यह तरीका, Google Chat ऐप्लिकेशन की पहचान है.
उपयोगकर्ता के इंटरैक्शन का जवाब देने के लिए, चैट ऐप्लिकेशन को इवेंट ऑब्जेक्ट को मैनेज करना होगा. साथ ही, इनमें से कोई एक JSON ऑब्जेक्ट दिखाना होगा:
DataActions: यह Google Workspace का डेटा बनाता है या उसे अपडेट करता है. चैट मैसेज भेजने या अपडेट करने के लिए, ऑब्जेक्ट में ऐसा मार्कअप होना चाहिए जोMessageडेटा में हुए बदलावों के बारे में बताता हो. इसेchatDataActionMarkupके तौर पर दिखाया जाता है.RenderActions: डायलॉग बनाएं या अपडेट करें. इसके अलावा, एक से ज़्यादा विकल्प चुनने वाले मेन्यू के लिए इनपुट के सुझाव दें.AuthorizationError: यह उपयोगकर्ताओं को अनुमति देने वाला कार्ड दिखाता है, ताकि वे Google से बाहर की किसी सेवा में साइन इन कर सकें या पुष्टि कर सकें. Chat में, सिर्फ़ बेसिक ऑथराइज़ेशन कार्ड इस्तेमाल किया जा सकता है.
| चैट ऐप्लिकेशन से मिला जवाब | सामान लौटाने के लिए ज़रूरी कार्रवाई |
|---|---|
| मैसेज भेजें या अपडेट करें. | DataActions |
| डायलॉग खोलें, अपडेट करें या बंद करें. | RenderActions |
| कार्ड या डायलॉग से जानकारी इकट्ठा करने के लिए, उपयोगकर्ताओं के मल्टीसिलेक्ट मेन्यू में टाइप किए गए टेक्स्ट के आधार पर, चुनने के लिए आइटम सुझाएं. | RenderActions |
| लिंक की झलक दिखाने की सुविधा, उन मैसेज में काम करती है जो Chat इस्तेमाल करने वाले लोग किसी स्पेस में भेजते हैं. | DataActions |
Google Chat API का इस्तेमाल करके जवाब देना
ऐड-ऑन की कार्रवाई का जवाब देने के बजाय, Chat ऐप्लिकेशन को इंटरैक्शन का जवाब देने के लिए, Google Chat API का इस्तेमाल करना पड़ सकता है. उदाहरण के लिए, Chat ऐप्लिकेशन को Google Chat API को कॉल करना होगा, ताकि इनमें से कोई भी काम किया जा सके:
- इंटरैक्शन के 30 सेकंड बाद जवाब दें.
- उस स्पेस के बाहर टास्क पूरे करना जहां इंटरैक्शन हुआ था.
- Chat में ऐसे टास्क पूरे करना जो ऐड-ऑन की कार्रवाइयों के तौर पर उपलब्ध नहीं हैं. उदाहरण के लिए, उन स्पेस की सूची बनाएं जिनमें कोई उपयोगकर्ता या Chat ऐप्लिकेशन सदस्य है या किसी स्पेस में उपयोगकर्ताओं को जोड़ें.
- Chat उपयोगकर्ता की ओर से टास्क पूरे करना. इसके लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है.
Chat API को प्रमाणित करने और कॉल करने के बारे में जानने के लिए, Chat API की खास जानकारी देखें.
मिलते-जुलते विषय
- Google Workspace ऐड-ऑन के लिए ट्रिगर
- Google Chat ऐप्लिकेशन को कॉन्फ़िगर करना
- इवेंट ऑब्जेक्ट
- ऐड-ऑन से जुड़ी कार्रवाइयां
- Google Chat में मैसेज भेजना
- इंटरैक्टिव डायलॉग बॉक्स खोलना
- Google Chat में भेजे गए मैसेज में मौजूद लिंक की झलक देखना
- Chat API के बारे में खास जानकारी