इस पेज पर एचटीटीपी Chat ऐप्लिकेशन बनाने का तरीका बताया गया है. इस आर्किटेक्चर को कई तरीकों से लागू किया जा सकता है. Google Cloud पर, आपको Cloud Functions, Cloud Run, और App Engine का इस्तेमाल कर सकते हैं. इस क्विकस्टार्ट में, आपको लिखें और डिप्लॉय करें क्लाउड फ़ंक्शन जिसे Chat ऐप्लिकेशन किसी उपयोगकर्ता के मैसेज का जवाब देने के लिए इस्तेमाल करता है.
इस आर्किटेक्चर में, Chat को कॉन्फ़िगर किया जा सकता है, ताकि Google Cloud या कंपनी की इमारत में मौजूद सर्वर को एचटीटीपी का इस्तेमाल करके, जैसा कि नीचे दिया गया डायग्राम:
पिछले डायग्राम में, किसी एचटीटीपी के साथ इंटरैक्ट करते हुए एक उपयोगकर्ता को दिखाया गया है 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 Console में, 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 ऐप्लिकेशन के लिए फ़ंक्शन बनाने और उसे डिप्लॉय करने के लिए, इन चरणों को पूरा करें:
Node.js
Google Cloud Console में, Cloud Functions पेज पर जाएं:
पक्का करें कि आपके Chat ऐप्लिकेशन का प्रोजेक्ट चुना गया.
फ़ंक्शन बनाएं पर क्लिक करें.
'फ़ंक्शन बनाएं' पेज पर, अपना फ़ंक्शन सेट अप करें:
- Environment में, 2nd gen को चुनें.
- फ़ंक्शन के नाम में
QuickStartChatApp
डालें. - क्षेत्र में जाकर, कोई देश/इलाका चुनें.
- 'पुष्टि करें' में जाकर, पुष्टि करना ज़रूरी है को चुनें.
- आगे बढ़ें पर क्लिक करें.
रनटाइम में, Node.js का सबसे नया वर्शन चुनें.
सोर्स कोड में, इनलाइन एडिटर चुनें.
एंट्री पॉइंट में जाकर, डिफ़ॉल्ट टेक्स्ट मिटाएं और
avatarApp
डालें.index.js
की सामग्री को इस कोड से बदलें:डिप्लॉय करें पर क्लिक करें.
Python
Google Cloud Console में, Cloud Functions पेज पर जाएं:
पक्का करें कि आपके Chat ऐप्लिकेशन का प्रोजेक्ट चुना गया.
फ़ंक्शन बनाएं पर क्लिक करें.
'फ़ंक्शन बनाएं' पेज पर, अपना फ़ंक्शन सेट अप करें:
- Environment में, 2nd gen को चुनें.
- फ़ंक्शन के नाम में
QuickStartChatApp
डालें. - क्षेत्र में जाकर, कोई देश/इलाका चुनें.
- 'पुष्टि करें' में जाकर, पुष्टि करना ज़रूरी है को चुनें.
- आगे बढ़ें पर क्लिक करें.
रनटाइम में जाकर, Python का सबसे नया वर्शन चुनें.
सोर्स कोड में, इनलाइन एडिटर चुनें.
एंट्री पॉइंट में जाकर, डिफ़ॉल्ट टेक्स्ट मिटाएं और
avatar_app
डालें.main.py
की सामग्री को इस कोड से बदलें:डिप्लॉय करें पर क्लिक करें.
Java
Google Cloud Console में, Cloud Functions पेज पर जाएं:
पक्का करें कि आपके Chat ऐप्लिकेशन का प्रोजेक्ट चुना गया.
फ़ंक्शन बनाएं पर क्लिक करें.
'फ़ंक्शन बनाएं' पेज पर, अपना फ़ंक्शन सेट अप करें:
- Environment में, 2nd gen को चुनें.
- फ़ंक्शन के नाम में
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 के फ़ंक्शन.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया हैपक्का करें कि आपने जिस प्रोजेक्ट के लिए 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 ऐप्लिकेशन चुनें. सीधे तौर पर होने वाला मैसेज खुलता है.
- ऐप्लिकेशन के नए डायरेक्ट मैसेज में,
Hello
टाइप करें औरenter
.
Chat ऐप्लिकेशन के जवाब में कार्ड मैसेज जो भेजने वाले का नाम और अवतार की इमेज, जैसा कि इस इमेज में दिखाया गया है:
भरोसेमंद जांच करने वाले लोगों को जोड़ने और इंटरैक्टिव सुविधाओं की जांच के बारे में ज़्यादा जानने के लिए, यहां देखें इसके लिए इंटरैक्टिव सुविधाओं की जांच करें Google Chat ऐप्लिकेशन.
समस्या हल करें
जब Google Chat ऐप्लिकेशन या card कोई गड़बड़ी दिखाता है, Chat के इंटरफ़ेस पर, "कोई गड़बड़ी हुई" मैसेज दिखता है. या "आपका अनुरोध प्रोसेस नहीं किया जा सका." कभी-कभी Chat यूज़र इंटरफ़ेस (यूआई) गड़बड़ी का कोई मैसेज नहीं दिखाता है. हालांकि, Chat ऐप्लिकेशन या कार्ड से कोई अनचाहा नतीजा मिलता है; उदाहरण के लिए, कार्ड मैसेज शायद वे नहीं दिखते.
हालांकि, Chat के यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी का मैसेज शायद न दिखे, गड़बड़ी ठीक करने में आपकी मदद करने के लिए, जानकारी देने वाले गड़बड़ी के मैसेज और लॉग डेटा उपलब्ध है जब चैट ऐप्लिकेशन के लिए गड़बड़ी लॉग करने की सेटिंग चालू हो. मदद के लिए, डीबग करने और गड़बड़ियां ठीक करने के लिए, देखें Google Chat से जुड़ी गड़बड़ियां हल करना और गड़बड़ियां ठीक करना.
व्यवस्थित करें
इसके लिए आपके Google Cloud खाते पर लगने वाले शुल्क से बचने के लिए तो हमारा सुझाव है कि आप Cloud प्रोजेक्ट शामिल है.
- Google Cloud Console में, संसाधन मैनेज करें पेज पर जाएं. क्लिक करें मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.
- प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे मिटाना है. इसके बाद, क्लिक करें मिटाएं .
- डायलॉग बॉक्स में, प्रोजेक्ट आईडी टाइप करें. इसके बाद, मिटाने के लिए शट डाउन करें पर क्लिक करें को भी शामिल किया है.
मिलते-जुलते विषय
अपने Chat ऐप्लिकेशन में ज़्यादा सुविधाएं जोड़ने के लिए, फ़ॉलो किया जा रहा है: