इस पेज पर, एचटीटीपी Chat ऐप्लिकेशन बनाने का तरीका बताया गया है. इस आर्किटेक्चर को लागू करने के अलग-अलग तरीके हैं. Google Cloud पर, Cloud Run और App Engine का इस्तेमाल किया जा सकता है. इस क्विकस्टार्ट में, Cloud Run का एक ऐसा फ़ंक्शन लिखा और डिप्लॉय किया जाता है जिसका इस्तेमाल Chat ऐप्लिकेशन, उपयोगकर्ता के मैसेज का जवाब देने के लिए करता है.
इस आर्किटेक्चर में, Chat को Google Cloud या कंपनी की इमारत में मौजूद सर्वर के साथ इंटिग्रेट करने के लिए, एचटीटीपी का इस्तेमाल किया जाता है. जैसा कि यहां दिए गए डायग्राम में दिखाया गया है:
ऊपर दिए गए डायग्राम में, एचटीटीपी Chat ऐप्लिकेशन के साथ इंटरैक्ट करने वाले उपयोगकर्ता के लिए, जानकारी का फ़्लो इस तरह होता है:
- कोई उपयोगकर्ता, Chat ऐप्लिकेशन को डायरेक्ट मैसेज या Chat स्पेस में मैसेज भेजता है.
- एक एचटीटीपी अनुरोध, वेब सर्वर को भेजा जाता है. यह वेब सर्वर, क्लाउड या कंपनी की इमारत में सिस्टम हो सकता है. इसमें Chat ऐप्लिकेशन की लॉजिक शामिल होती है.
- Chat ऐप्लिकेशन की लॉजिक को, Google Workspace की सेवाओं (जैसे, Calendar और Sheets), Google की अन्य सेवाओं (जैसे, Maps, YouTube, और Vertex AI) या अन्य वेब सेवाओं (जैसे, प्रोजेक्ट मैनेजमेंट सिस्टम या टिकट टूल) के साथ इंटिग्रेट किया जा सकता है.
- वेब सर्वर, Chat में मौजूद Chat ऐप्लिकेशन सेवा को एचटीटीपी रिस्पॉन्स वापस भेजता है.
- यह रिस्पॉन्स, उपयोगकर्ता को डिलीवर किया जाता है.
- Chat ऐप्लिकेशन, Chat API को कॉल करके, एसिंक्रोनस तरीके से मैसेज पोस्ट कर सकता है या अन्य कार्रवाइयां कर सकता है.
इस आर्किटेक्चर की मदद से, आपके पास मौजूदा लाइब्रेरी और कॉम्पोनेंट इस्तेमाल करने की सुविधा होती है. ऐसा इसलिए, क्योंकि इन Chat ऐप्लिकेशन को अलग-अलग प्रोग्रामिंग भाषाओं का इस्तेमाल करके डिज़ाइन किया जा सकता है.
मकसद
- अपना एनवायरमेंट सेट अप करना.
- Cloud Run का फ़ंक्शन बनाना और उसे डिप्लॉय करना.
- ऐप्लिकेशन को Chat पर पब्लिश करना.
- ऐप्लिकेशन की जांच करना.
ज़रूरी शर्तें
- Business या Enterprise Google Workspace खाता, जिसमें Google Chat का ऐक्सेस हो.
- बिलिंग की सुविधा वाला Google क्लाउड प्रोजेक्ट. यह देखने के लिए कि किसी मौजूदा प्रोजेक्ट में बिलिंग की सुविधा चालू है या नहीं, देखें अपने प्रोजेक्ट की बिलिंग की स्थिति की पुष्टि करना. कोई प्रोजेक्ट बनाने और बिलिंग सेट अप करने के लिए, Google Cloud प्रोजेक्ट बनाना लेख पढ़ें.
एनवायरमेंट सेट अप करना
Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. किसी एक Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.Google API कंसोल में, Google Chat API, Cloud Build API, Cloud Functions API, Cloud Pub/Sub API, Cloud Logging API, Artifact Registry API, और Cloud Run API चालू करें.
Cloud Run का फ़ंक्शन बनाना और उसे डिप्लॉय करना
Cloud Run का एक ऐसा फ़ंक्शन बनाएं और उसे डिप्लॉय करें जो Chat कार्ड जनरेट करता है. इस कार्ड में, भेजने वाले का डिसप्ले नेम और अवतार इमेज दिखती है. Chat ऐप्लिकेशन को मैसेज मिलने पर, वह इस फ़ंक्शन को रन करता है और कार्ड के साथ जवाब देता है.
अपने Chat ऐप्लिकेशन के लिए फ़ंक्शन बनाने और उसे डिप्लॉय करने के लिए, यह तरीका अपनाएं:
Node.js
Google API कंसोल में, Cloud Run पेज पर जाएं:
पक्का करें कि आपके Chat ऐप्लिकेशन के लिए प्रोजेक्ट चुना गया हो.
कोई फ़ंक्शन लिखें पर क्लिक करें.
सेवा बनाएं पेज पर, अपना फ़ंक्शन सेट अप करें:
- सेवा का नाम फ़ील्ड में,
quickstartchatappडालें. - इलाका सूची में, कोई इलाका चुनें.
- रनटाइम सूची में, Node.js का सबसे नया वर्शन चुनें.
- पुष्टि सेक्शन में, पुष्टि करना ज़रूरी है को चुनें.
- बनाएं पर क्लिक करें और Cloud Run के सेवा बनाने का इंतज़ार करें. कंसोल, आपको सोर्स टैब पर रीडायरेक्ट करता है.
- सेवा का नाम फ़ील्ड में,
सोर्स टैब में:
- एंट्री पॉइंट में, डिफ़ॉल्ट टेक्स्ट मिटाएं और
avatarAppडालें. index.jsके कॉन्टेंट को इस कोड से बदलें:सेव करें और फिर से डिप्लॉय करें पर क्लिक करें.
- एंट्री पॉइंट में, डिफ़ॉल्ट टेक्स्ट मिटाएं और
Python
Google API कंसोल में, Cloud Run पेज पर जाएं:
पक्का करें कि आपके Chat ऐप्लिकेशन के लिए प्रोजेक्ट चुना गया हो.
कोई फ़ंक्शन लिखें पर क्लिक करें.
सेवा बनाएं पेज पर, अपना फ़ंक्शन सेट अप करें:
- सेवा का नाम फ़ील्ड में,
quickstartchatappडालें. - इलाका सूची में, कोई इलाका चुनें.
- रनटाइम सूची में, Python का सबसे नया वर्शन चुनें.
- पुष्टि सेक्शन में, पुष्टि करना ज़रूरी है को चुनें.
- बनाएं पर क्लिक करें और Cloud Run के सेवा बनाने का इंतज़ार करें. कंसोल, आपको सोर्स टैब पर रीडायरेक्ट करता है.
- सेवा का नाम फ़ील्ड में,
सोर्स टैब में:
- एंट्री पॉइंट में, डिफ़ॉल्ट टेक्स्ट मिटाएं और
avatar_appडालें. main.pyके कॉन्टेंट को इस कोड से बदलें:सेव करें और फिर से डिप्लॉय करें पर क्लिक करें.
- एंट्री पॉइंट में, डिफ़ॉल्ट टेक्स्ट मिटाएं और
Java
Google API कंसोल में, Cloud Run पेज पर जाएं:
पक्का करें कि आपके Chat ऐप्लिकेशन के लिए प्रोजेक्ट चुना गया हो.
कोई फ़ंक्शन लिखें पर क्लिक करें.
सेवा बनाएं पेज पर, अपना फ़ंक्शन सेट अप करें:
- सेवा का नाम फ़ील्ड में,
quickstartchatappडालें. - इलाका सूची में, कोई इलाका चुनें.
- रनटाइम सूची में, Java का सबसे नया वर्शन चुनें.
- पुष्टि सेक्शन में, पुष्टि करना ज़रूरी है को चुनें.
- बनाएं पर क्लिक करें और Cloud Run के सेवा बनाने का इंतज़ार करें. कंसोल, आपको सोर्स टैब पर रीडायरेक्ट करता है.
- सेवा का नाम फ़ील्ड में,
सोर्स टैब में:
- एंट्री पॉइंट में, डिफ़ॉल्ट टेक्स्ट मिटाएं और
Appडालें. src/main/java/com/example/Example.javaका नाम बदलकरsrc/main/java/AvatarApp.javaकरें.AvatarApp.javaके कॉन्टेंट को इस कोड से बदलें:pom.xmlके कॉन्टेंट को इस कोड से बदलें:सेव करें और फिर से डिप्लॉय करें पर क्लिक करें.
- एंट्री पॉइंट में, डिफ़ॉल्ट टेक्स्ट मिटाएं और
Google Chat को अपना फ़ंक्शन कॉल करने की अनुमति देना
Google Chat को अपना फ़ंक्शन कॉल करने की अनुमति देने के लिए, Google Chat के सेवा खाते को Cloud Run Invoker की भूमिका असाइन करें.
Google API कंसोल में, Cloud Run पेज पर जाएं:
Cloud Run की सेवाओं की सूची में, उस फ़ंक्शन के बगल में मौजूद चेकबॉक्स को चुनें जिसे कॉल करना है. (फ़ंक्शन पर क्लिक न करें.)
अनुमतियां पर क्लिक करें. अनुमतियां पैनल खुलता है.
प्रिंसिपल जोड़ें पर क्लिक करें.
**नए प्रिंसिपल** में,
chat@system.gserviceaccount.comडालें.कोई भूमिका चुनें में, Cloud Run > Cloud Run Invoker को चुनें.
सेव करें पर क्लिक करें.
Chat ऐप्लिकेशन को कॉन्फ़िगर करना
Cloud Run का फ़ंक्शन डिप्लॉय हो जाने के बाद, उसे Google Chat ऐप्लिकेशन में बदलने के लिए, यह तरीका अपनाएं:
Google API कंसोल में, Cloud Run पेज पर जाएं:
पक्का करें कि वह प्रोजेक्ट चुना गया हो जिसके लिए आपने Cloud Run चालू किया है
सेवाओं की सूची में, quickstartchatapp पर क्लिक करें.
सेवा की जानकारी पेज पर, फ़ंक्शन का यूआरएल कॉपी करें.
"Google Chat API" खोजें और Google Chat API पर क्लिक करें. इसके बाद, मैनेज करें पर क्लिक करें.
कॉन्फ़िगरेशन पर क्लिक करें और Google Chat ऐप्लिकेशन सेट अप करें:
- इस Chat ऐप्लिकेशन को Google Workspace के ऐड-ऑन के तौर पर बनाएं को साफ़ करें. पुष्टि करने के लिए एक डायलॉग खुलता है. डायलॉग में, बंद करें पर क्लिक करें.
- ऐप्लिकेशन का नाम में,
Quickstart Appडालें. - अवतार यूआरएल में,
https://developers.google.com/chat/images/quickstart-app-avatar.pngडालें. - **जानकारी** में,
Quickstart appडालें. - सुविधाएं में, स्पेस और ग्रुप बातचीत में शामिल हों को चुनें.
- कनेक्शन की सेटिंग में, एचटीटीपी एंडपॉइंट यूआरएल को चुनें.
- ट्रिगर में, सभी ट्रिगर के लिए एक ही एचटीटीपी एंडपॉइंट यूआरएल का इस्तेमाल करें को चुनें. इसके बाद, बॉक्स में Cloud Run के फ़ंक्शन ट्रिगर का यूआरएल चिपकाएं.
- विज़िबिलिटी में, अपने डोमेन में इस Chat ऐप्लिकेशन को चुनिंदा लोगों और ग्रुप के लिए उपलब्ध कराएं को चुनें और अपना ईमेल पता डालें.
- लॉग में, लॉगिंग में गड़बड़ियां लॉग करें को चुनें.
सेव करें पर क्लिक करें.
Chat ऐप्लिकेशन, Chat पर मैसेज पाने और उनका जवाब देने के लिए तैयार है.
अपने Chat ऐप्लिकेशन की जांच करना
अपने Chat ऐप्लिकेशन की जांच करने के लिए, Chat ऐप्लिकेशन के साथ डायरेक्ट मैसेज वाला स्पेस खोलें और कोई मैसेज भेजें:
Google Workspace के उस खाते का इस्तेमाल करके Google Chat खोलें जिसे आपने भरोसेमंद टेस्टर के तौर पर खुद को जोड़ते समय दिया था.
- नई चैट पर क्लिक करें.
- एक या उससे ज़्यादा लोग जोड़ें फ़ील्ड में, अपने Chat ऐप्लिकेशन का नाम डालें.
नतीजों में से अपना Chat ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलता है.
- ऐप्लिकेशन के साथ नए डायरेक्ट मैसेज में,
Helloलिखें औरenterदबाएं.
Chat ऐप्लिकेशन के जवाब में एक कार्ड मैसेज होता है. इसमें, भेजने वाले का नाम और अवतार इमेज दिखती है. जैसा कि यहां दी गई इमेज में दिखाया गया है:
भरोसेमंद टेस्टर जोड़ने और इंटरैक्टिव सुविधाओं की जांच करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन के लिए इंटरैक्टिव सुविधाओं की जांच करना लेख पढ़ें.
समस्या हल करें
जब Google Chat ऐप्लिकेशन या कार्ड में कोई गड़बड़ी होती है, तो Chat इंटरफ़ेस पर "कोई गड़बड़ी हुई" मैसेज दिखता है. या "आपका अनुरोध प्रोसेस नहीं किया जा सका." कभी-कभी Chat यूज़र इंटरफ़ेस (यूआई) पर कोई गड़बड़ी का मैसेज नहीं दिखता, लेकिन Chat ऐप्लिकेशन या कार्ड से उम्मीद के मुताबिक नतीजे नहीं मिलते. उदाहरण के लिए, कार्ड मैसेज नहीं दिख सकता.
Chat यूआई में गड़बड़ी का मैसेज नहीं दिखने पर भी, गड़बड़ी की जानकारी देने वाले मैसेज और लॉग डेटा उपलब्ध होते हैं. इनसे, गड़बड़ियों को ठीक करने में मदद मिलती है जब Chat ऐप्लिकेशन के लिए गड़बड़ी लॉग करने की सुविधा चालू हो. गड़बड़ियां देखने, डीबग करने, और ठीक करने में मदद पाने के लिए, Google Chat की गड़बड़ियां ठीक करना लेख पढ़ें.
स्टोरेज में जगह बनाएं
इस ट्यूटोरियल में इस्तेमाल किए गए संसाधनों के लिए, अपने Google Cloud खाते से शुल्क न लिए जाने के लिए, हमारा सुझाव है कि आप क्लाउड प्रोजेक्ट मिटा दें.
- Google API कंसोल में, संसाधन मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.
- प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे आपको मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
- डायलॉग में, प्रोजेक्ट आईडी डालें. इसके बाद, प्रोजेक्ट को मिटाने के लिए बंद करें पर क्लिक करें.
मिलते-जुलते विषय
अपने Chat ऐप्लिकेशन में ज़्यादा सुविधाएं जोड़ने के लिए, यह लेख पढ़ें: