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