इस पेज पर एचटीटीपी चैट ऐप्लिकेशन बनाने का तरीका बताया गया है. इस आर्किटेक्चर को लागू करने के कई तरीके हैं. Google Cloud पर, Cloud Functions, Cloud Run, और App Engine का इस्तेमाल किया जा सकता है. इस क्विकस्टार्ट में, ऐसा क्लाउड फ़ंक्शन लिखा और डिप्लॉय किया जा सकता है जिसका इस्तेमाल, Chat ऐप्लिकेशन किसी उपयोगकर्ता के मैसेज का जवाब देने के लिए करता है.
इस आर्किटेक्चर से, एचटीटीपी का इस्तेमाल करके Chat को Google Cloud या कंपनी की इमारत में बने सर्वर के साथ इंटिग्रेट करने के लिए कॉन्फ़िगर किया जा सकता है, जैसा कि यहां दिए गए डायग्राम में दिखाया गया है:
पिछले डायग्राम में, एचटीटीपी चैट ऐप्लिकेशन से इंटरैक्ट करने वाले उपयोगकर्ता के पास जानकारी का यह फ़्लो है:
- उपयोगकर्ता, Chat ऐप्लिकेशन को डायरेक्ट मैसेज या चैट स्पेस में मैसेज भेजता है.
- एचटीटीपी अनुरोध ऐसे वेब सर्वर पर भेजा जाता है जो क्लाउड या कंपनी की इमारत में मौजूद सिस्टम हो सकता है. इस सिस्टम में Chat ऐप्लिकेशन लॉजिक शामिल होता है.
- इसके अलावा, Chat ऐप्लिकेशन लॉजिक को Google Workspace की सेवाओं (जैसे, Calendar और Sheets), Google की अन्य सेवाओं, जैसे कि Maps, YouTube, और Vertex AI के साथ इंटिग्रेट किया जा सकता है. इसके अलावा, प्रोजेक्ट मैनेजमेंट सिस्टम या टिकट बेचने वाले टूल जैसी अन्य वेब सेवाओं के साथ भी इंटिग्रेट किया जा सकता है.
- वेब सर्वर, Chat में मौजूद Chat ऐप्लिकेशन सेवा को वापस एचटीटीपी रिस्पॉन्स भेजता है.
- उपयोगकर्ता को जवाब दे दिया जाता है.
- इसके अलावा, Chat ऐप्लिकेशन, Chat API को कॉल करके, एसिंक्रोनस तरीके से मैसेज पोस्ट कर सकता है या दूसरे काम कर सकता है.
इस आर्किटेक्चर से आपको अपने सिस्टम में पहले से मौजूद लाइब्रेरी और कॉम्पोनेंट का इस्तेमाल करने की सुविधा मिलती है, क्योंकि इन चैट ऐप्लिकेशन को अलग-अलग प्रोग्रामिंग भाषाओं का इस्तेमाल करके डिज़ाइन किया जा सकता है.
मकसद
- अपना एनवायरमेंट सेट अप करें.
- Cloud फ़ंक्शन बनाना और डिप्लॉय करना.
- Chat में ऐप्लिकेशन पब्लिश करें.
- ऐप्लिकेशन को टेस्ट करें.
ज़रूरी शर्तें
- Google Workspace खाता, जिसमें Google Workspace का इस्तेमाल करने वाले किसी ऐसे संगठन में Google Chat का ऐक्सेस हो जो बिना पुष्टि किए Google Cloud फ़ंक्शन को शुरू करने की अनुमति देता है.
- Google Cloud प्रोजेक्ट.
- पक्का करें कि आपने 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 जैसी सुविधाएं चालू करें.
क्लाउड फ़ंक्शन बनाना और डिप्लॉय करना
ऐसा क्लाउड फ़ंक्शन बनाएं और डिप्लॉय करें जो भेजने वाले के डिसप्ले नेम और अवतार इमेज के साथ चैट कार्ड जनरेट करता हो. जब Chat ऐप्लिकेशन को मैसेज मिलता है, तो वह फ़ंक्शन चलाता है और कार्ड से जवाब देता है.
अपने Chat ऐप्लिकेशन के लिए फ़ंक्शन बनाने और डिप्लॉय करने के लिए, यह तरीका अपनाएं:
Node.js
Google Cloud Console में, Cloud Functions पेज पर जाएं:
पक्का करें कि आपके Chat ऐप्लिकेशन का प्रोजेक्ट चुना गया हो.
फ़ंक्शन बनाएं पर क्लिक करें.
'फ़ंक्शन बनाएं' पेज पर, अपना फ़ंक्शन सेट अप करें:
- एनवायरमेंट में, 2nd gen चुनें.
- फ़ंक्शन का नाम में,
QuickStartChatApp
डालें. - क्षेत्र में, कोई इलाका चुनें.
- 'पुष्टि करना' में जाकर, उन बातचीत को अनुमति दें जिनकी पुष्टि नहीं की गई है को चुनें.
- आगे बढ़ें पर क्लिक करें.
रनटाइम में, Node.js 20 चुनें.
सोर्स कोड में, इनलाइन एडिटर चुनें.
एंट्री पॉइंट में, डिफ़ॉल्ट टेक्स्ट मिटाएं और
helloChat
डालें.index.js
के कॉन्टेंट को नीचे दिए गए कोड से बदलें:डिप्लॉय करें पर क्लिक करें.
Python
Google Cloud Console में, Cloud Functions पेज पर जाएं:
पक्का करें कि आपके Chat ऐप्लिकेशन का प्रोजेक्ट चुना गया हो.
फ़ंक्शन बनाएं पर क्लिक करें.
'फ़ंक्शन बनाएं' पेज पर, अपना फ़ंक्शन सेट अप करें:
- फ़ंक्शन का नाम में,
QuickStartChatApp
डालें. - ट्रिगर टाइप में, एचटीटीपी चुनें.
- 'पुष्टि करना' में जाकर, उन बातचीत को अनुमति दें जिनकी पुष्टि नहीं की गई है को चुनें.
- सेव करें पर क्लिक करें.
- आगे बढ़ें पर क्लिक करें.
- फ़ंक्शन का नाम में,
रनटाइम में, Python 3.10 चुनें.
सोर्स कोड में, इनलाइन एडिटर चुनें.
एंट्री पॉइंट में, डिफ़ॉल्ट टेक्स्ट मिटाएं और
hello_chat
डालें.main.py
के कॉन्टेंट को नीचे दिए गए कोड से बदलें:डिप्लॉय करें पर क्लिक करें.
Java
Google Cloud Console में, Cloud Functions पेज पर जाएं:
पक्का करें कि आपके Chat ऐप्लिकेशन का प्रोजेक्ट चुना गया हो.
फ़ंक्शन बनाएं पर क्लिक करें.
'फ़ंक्शन बनाएं' पेज पर, अपना फ़ंक्शन सेट अप करें:
- फ़ंक्शन का नाम में,
QuickStartChatApp
डालें. - ट्रिगर टाइप में, एचटीटीपी चुनें.
- 'पुष्टि करना' में जाकर, उन बातचीत को अनुमति दें जिनकी पुष्टि नहीं की गई है को चुनें.
- सेव करें पर क्लिक करें.
- आगे बढ़ें पर क्लिक करें.
- फ़ंक्शन का नाम में,
रनटाइम में, Java 11 चुनें.
सोर्स कोड में, इनलाइन एडिटर चुनें.
एंट्री पॉइंट में, डिफ़ॉल्ट टेक्स्ट मिटाएं और
HelloChat
डालें.src/main/java/com/example/Example.java
का नाम बदलकरsrc/main/java/HelloChat.java
करें.HelloChat.java
के कॉन्टेंट को नीचे दिए गए कोड से बदलें:pom.xml
के कॉन्टेंट को नीचे दिए गए कोड से बदलें:डिप्लॉय करें पर क्लिक करें.
ऐसा करने पर, Cloud Functions की जानकारी वाला पेज खुलेगा. इसके बाद, आपको दो फ़ंक्शन दिखेंगे: पहला, बिल्ड के लिए और दूसरा सेवा के लिए. जब प्रोग्रेस के दोनों इंडिकेटर गायब हो जाते हैं और उनकी जगह सही का निशान दिखने लगता है, तब आपका फ़ंक्शन डिप्लॉय हो जाता है और तैयार हो जाता है.
ऐप्लिकेशन को Google Chat पर पब्लिश करें
Cloud फ़ंक्शन के डिप्लॉय होने के बाद, इसे Google Chat ऐप्लिकेशन में बदलने के लिए यह तरीका अपनाएं:
Google Cloud Console में, मेन्यू > क्लाउड फ़ंक्शन पर क्लिक करें.
पक्का करें कि आपने जिस प्रोजेक्ट के लिए 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 मैसेज पाएं और स्पेस और ग्रुप बातचीत में शामिल हों चुनें.
- कनेक्शन सेटिंग में जाकर, ऐप्लिकेशन यूआरएल चुनें. इसके बाद, क्लाउड फ़ंक्शन ट्रिगर के यूआरएल को बॉक्स में चिपकाएं.
- किसको दिखे में जाकर, अपने डोमेन के खास लोगों और ग्रुप को यह Google Chat ऐप्लिकेशन उपलब्ध कराएं को चुनें और अपना ईमेल पता डालें.
- लॉग में जाकर, लॉगिंग में गड़बड़ियों को लॉग करें चुनें.
- ऐप्लिकेशन का नाम में,
सेव करें पर क्लिक करें.
Chat ऐप्लिकेशन से Chat पर मैसेज पाए जा सकते हैं. साथ ही, मैसेज का जवाब भी दिया जा सकता है.
अपने Chat ऐप्लिकेशन को टेस्ट करें
अपने Chat ऐप्लिकेशन की जांच करने के लिए, Chat ऐप्लिकेशन से डायरेक्ट मैसेज स्पेस खोलें और मैसेज भेजें:
Google Chat को उस Google Workspace खाते का इस्तेमाल करके खोलें जिसे आपने भरोसेमंद टेस्टर के तौर पर जोड़ते समय दिया था.
- नई चैट पर क्लिक करें.
- एक या इससे ज़्यादा लोगों को जोड़ें फ़ील्ड में, अपने Chat ऐप्लिकेशन का नाम लिखें.
नतीजों में से अपना Chat ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलेगा.
- ऐप्लिकेशन में नए डायरेक्ट मैसेज में,
Hello
टाइप करें औरenter
दबाएं.
Chat ऐप्लिकेशन के जवाब में एक कार्ड मैसेज होता है, जिसमें ईमेल भेजने वाले का नाम और अवतार इमेज दिखती है, जैसा कि इस इमेज में दिखाया गया है:
भरोसेमंद टेस्टर जोड़ने और इंटरैक्टिव सुविधाओं को टेस्ट करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन के लिए इंटरैक्टिव सुविधाओं की जांच करना लेख पढ़ें.
समस्या हल करें
जब Google Chat के किसी ऐप्लिकेशन या कार्ड पर कोई गड़बड़ी दिखती है, तो Chat के इंटरफ़ेस पर "कोई गड़बड़ी हुई" मैसेज दिखता है. या "आपके अनुरोध को प्रोसेस नहीं कर पा रहे हैं." कभी-कभी Chat के यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी का कोई मैसेज नहीं दिखता, लेकिन Chat ऐप्लिकेशन या कार्ड से अनचाहा नतीजा मिलता है. उदाहरण के लिए, हो सकता है कि कार्ड पर कोई मैसेज न दिखे.
हो सकता है कि Chat के यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी का मैसेज न दिखे. हालांकि, चैट ऐप्लिकेशन में गड़बड़ी को लॉग करने की सुविधा चालू होने पर, गड़बड़ियों को ठीक करने के लिए, गड़बड़ी के मैसेज और लॉग डेटा उपलब्ध होते हैं. गड़बड़ियों को देखने, डीबग करने, और ठीक करने में मदद पाने के लिए, Google Chat की गड़बड़ियों को ठीक करना और उन्हें हल करना देखें.
व्यवस्थित करें
हमारा सुझाव है कि इस ट्यूटोरियल में इस्तेमाल किए गए संसाधनों के लिए, आपके Google Cloud खाते पर शुल्क न पड़े. इसके लिए, हमारा सुझाव है कि आप Cloud प्रोजेक्ट मिटा दें.
- Google Cloud Console में, संसाधनों को मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.
- प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
- डायलॉग बॉक्स में, प्रोजेक्ट आईडी टाइप करें. इसके बाद, प्रोजेक्ट मिटाने के लिए, शट डाउन करें पर क्लिक करें.
मिलते-जुलते विषय
अपने Chat ऐप्लिकेशन में और सुविधाएं जोड़ने के लिए, ये चीज़ें देखें: