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