इस पेज पर बताया गया है कि Google Chat ऐप्लिकेशन का इस्तेमाल करके Chat ऐप्लिकेशन कैसे बनाएं Pub/Sub. इस तरह का Chat ऐप्लिकेशन का आर्किटेक्चर काम का है अगर आपके संगठन में फ़ायरवॉल मौजूद है, तो अपने Chat ऐप्लिकेशन पर मैसेज भेजने या Chat ऐप्लिकेशन, Google Workspace Events API. हालांकि, इस आर्किटेक्चर की ये सीमाएं हैं. इसकी वजह यह है कि इन चैट ऐप्लिकेशन सिर्फ़ भेज और पा सकते हैं एसिंक्रोनस मैसेज:
- डायलॉग का इस्तेमाल नहीं किया जा सकता दिखाई देता है. इसके बजाय, किसी कार्ड मैसेज.
- सिंक्रोनस रिस्पॉन्स से अलग-अलग कार्ड की जानकारी अपडेट नहीं की जा सकती. इसके बजाय, अपडेट करें
तो आप
patch
तरीका.
नीचे दिए गए डायग्राम में, Pub/Sub की मदद से बनाए गए चैट ऐप्लिकेशन:
पिछले डायग्राम में, Pub/Sub के साथ इंटरैक्ट करता कोई उपयोगकर्ता Chat ऐप्लिकेशन में नीचे दी गई जानकारी मौजूद होती है:
कोई उपयोगकर्ता Chat में किसी Chat ऐप्लिकेशन, डायरेक्ट मैसेज में या चैट स्पेस या चैट स्पेस में होने वाला कोई इवेंट जिसके लिए Chat ऐप्लिकेशन चालू है सदस्यता.
Chat, किसी Pub/Sub विषय पर मैसेज भेजता है.
ऐसा ऐप्लिकेशन सर्वर जो क्लाउड या कंपनी की इमारत में मौजूद सिस्टम होता है इसमें Chat ऐप्लिकेशन का लॉजिक शामिल होता है. साथ ही, इसकी सदस्यता लेता है फ़ायरवॉल के ज़रिए मैसेज पाने के लिए Pub/Sub विषय.
वैकल्पिक रूप से, Chat ऐप्लिकेशन Chat API की मदद से, एसिंक्रोनस तरीके से मैसेज पोस्ट किए जा सकते हैं या अन्य काम किए जा सकते हैं कार्रवाइयां.
ज़रूरी शर्तें
Java
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
- आपके पास ऐसा Google Cloud प्रोजेक्ट होना चाहिए जिसमें बिलिंग की सुविधा चालू हो. यह देखने के लिए कि किसी मौजूदा प्रोजेक्ट में बिलिंग की सुविधा चालू है या नहीं, देखें आपके प्रोजेक्ट की बिलिंग स्थिति. प्रोजेक्ट बनाने और बिलिंग सेट अप करने के लिए, यहां जाएं Google Cloud प्रोजेक्ट बनाएं.
- Java 11 या उसके बाद का वर्शन
- Maven पैकेज मैनेजमेंट टूल
Python
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
- आपके पास ऐसा Google Cloud प्रोजेक्ट होना चाहिए जिसमें बिलिंग की सुविधा चालू हो. यह देखने के लिए कि किसी मौजूदा प्रोजेक्ट में बिलिंग की सुविधा चालू है या नहीं, देखें आपके प्रोजेक्ट की बिलिंग स्थिति. प्रोजेक्ट बनाने और बिलिंग सेट अप करने के लिए, यहां जाएं Google Cloud प्रोजेक्ट बनाएं.
- Python 3.6 या इससे नया वर्शन
- पीआईपी पैकेज मैनेजमेंट टूल
Node.js
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
- आपके पास ऐसा Google Cloud प्रोजेक्ट होना चाहिए जिसमें बिलिंग की सुविधा चालू हो. यह देखने के लिए कि किसी मौजूदा प्रोजेक्ट में बिलिंग की सुविधा चालू है या नहीं, देखें आपके प्रोजेक्ट की बिलिंग स्थिति. प्रोजेक्ट बनाने और बिलिंग सेट अप करने के लिए, यहां जाएं Google Cloud प्रोजेक्ट बनाएं.
- Node.js 14 या उसके बाद का वर्शन
- npm पैकेज मैनेजमेंट टूल
-
शुरू किया गया Node.js प्रोजेक्ट. नया प्रोजेक्ट शुरू करने के लिए, प्रोजेक्ट बनाएं और
नए फ़ोल्डर में स्विच करें, फिर अपने कमांड-लाइन इंटरफ़ेस में यहां दिया गया कमांड चलाएं:
npm init
एनवायरमेंट को सेट अप करना
Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. किसी एक Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.Google Cloud Console में, Google Chat API और Pub/Sub एपीआई को चालू करें.
Pub/Sub सेट अप करना
Pub/Sub के लिए कोई विषय बनाना जिनका इस्तेमाल करने पर Chat API मैसेज भेज सकता है. हमारी सलाह है कि आप हर Chat ऐप्लिकेशन पर एक विषय.
Chat को पब्लिश करने की अनुमति देना विषय से जुड़ी जानकारी पाने के लिए, इन्हें Pub/Sub पब्लिशर की भूमिका असाइन करें सेवा खाता:
chat-api-push@system.gserviceaccount.com
सेवा खाता बनाना Chat ऐप्लिकेशन को Pub/Sub और निजी कुंजी फ़ाइल से चैट करें और उसे अपनी वर्किंग डायरेक्ट्री में सेव करें.
पुल सदस्यता बनाना करना है.
सदस्यता के लिए, Pub/Sub के सदस्यों की भूमिका असाइन करना आपके इस्तेमाल के लिए तय किया गया है.
स्क्रिप्ट लिखें
Java
सीएलआई में, सेवा खाते के क्रेडेंशियल दें:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
सीएलआई में, Google Cloud प्रोजेक्ट आईडी दें:
export PROJECT_ID=PROJECT_ID
सीएलआई में, Pub/Sub सदस्यता के लिए वह सदस्यता आईडी दें जो जिसे आपने पहले बनाया था:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
अपनी वर्किंग डायरेक्ट्री में,
pom.xml
नाम की फ़ाइल बनाएं.pom.xml
फ़ाइल में, यह कोड चिपकाएं:अपनी वर्किंग डायरेक्ट्री में,
src/main/java
डायरेक्ट्री स्ट्रक्चर बनाएं.src/main/java
डायरेक्ट्री में,Main.java
नाम की फ़ाइल बनाएं.Main.java
में, यह कोड चिपकाएं:
Python
सीएलआई में, सेवा खाते के क्रेडेंशियल दें:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
सीएलआई में, Google Cloud प्रोजेक्ट आईडी दें:
export PROJECT_ID=PROJECT_ID
सीएलआई में, Pub/Sub सदस्यता के लिए वह सदस्यता आईडी दें जो जिसे आपने पहले बनाया था:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
अपनी वर्किंग डायरेक्ट्री में,
requirements.txt
नाम की फ़ाइल बनाएं.requirements.txt
फ़ाइल में, यह कोड चिपकाएं:अपनी वर्किंग डायरेक्ट्री में,
app.py
नाम की फ़ाइल बनाएं.app.py
में, यह कोड चिपकाएं:
Node.js
सीएलआई में, सेवा खाते के क्रेडेंशियल दें:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
सीएलआई में, Google Cloud प्रोजेक्ट आईडी दें:
export PROJECT_ID=PROJECT_ID
सीएलआई में, Pub/Sub सदस्यता के लिए वह सदस्यता आईडी दें जो जिसे आपने पहले बनाया था:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
अपनी वर्किंग डायरेक्ट्री में,
package.json
नाम की फ़ाइल बनाएं.package.json
फ़ाइल में, यह कोड चिपकाएं:अपनी वर्किंग डायरेक्ट्री में,
index.js
नाम की फ़ाइल बनाएं.index.js
में, यह कोड चिपकाएं:
Chat में ऐप्लिकेशन पब्लिश करें
Google Cloud Console में, मेन्यू पर जाएं > एपीआई और सेवाएं > चालू एपीआई और सेवाएं > Google Chat एपीआई > कॉन्फ़िगरेशन.
Pub/Sub के लिए चैट ऐप्लिकेशन को कॉन्फ़िगर करें:
- ऐप्लिकेशन के नाम में
Quickstart App
डालें. - अवतार यूआरएल में,
https://developers.google.com/chat/images/quickstart-app-avatar.png
डालें. - जानकारी में,
Quickstart app
डालें. - फ़ंक्शनलता में जाकर, 1:1 मैसेज पाएं और स्पेस और ग्रुप बातचीत में शामिल हों को चुनें.
- कनेक्शन सेटिंग में जाकर, Cloud Pub/Sub को चुनें और Pub/Sub के आपके उस विषय का नाम जिसे आपने पहले बनाया था.
- किसको दिखे सेक्शन में जाकर, अपने डोमेन के इस Google Chat ऐप्लिकेशन को चुनिंदा लोगों और ग्रुप के लिए उपलब्ध कराएं को चुनें और अपना ईमेल पता डालें.
- लॉग में जाकर, लॉग करने में गड़बड़ियों को लॉग करें चुनें.
- ऐप्लिकेशन के नाम में
सेव करें पर क्लिक करें.
इस ऐप्लिकेशन के ज़रिए Chat पर मैसेज भेजे जा सकते हैं और उनका जवाब दिया जा सकता है.
स्क्रिप्ट चलाएं
किसी सीएलआई में, अपनी वर्किंग डायरेक्ट्री पर स्विच करें और स्क्रिप्ट चलाएं:
Java
mvn compile exec:java -Dexec.mainClass=Main
Python
python -m venv env
source env/bin/activate
pip install -r requirements.txt -U
python app.py
Node.js
npm install
npm start
कोड चलाने पर, यह ऐप्लिकेशन पब्लिश किए गए मैसेज को सुनना शुरू कर देता है Pub/Sub विषय से जुड़ा होना चाहिए.
Chat ऐप्लिकेशन को टेस्ट करें
Chat ऐप्लिकेशन को टेस्ट करने के लिए, कोई डायरेक्ट मैसेज स्पेस खोलें चैट ऐप्लिकेशन खोलें और मैसेज भेजें:
उस Google Workspace खाते का इस्तेमाल करके Google Chat खोलें जब आपने खुद को भरोसेमंद टेस्टर के तौर पर जोड़ा हो.
- नई चैट पर क्लिक करें.
- एक या उससे ज़्यादा लोगों को जोड़ें फ़ील्ड में, अपने चैट ऐप्लिकेशन.
नतीजों में से Chat ऐप्लिकेशन चुनें. सीधे तौर पर होने वाला मैसेज खुलता है.
- ऐप्लिकेशन के नए डायरेक्ट मैसेज में,
Hello
टाइप करें औरenter
.
भरोसेमंद जांच करने वाले लोगों को जोड़ने और इंटरैक्टिव सुविधाओं की जांच के बारे में ज़्यादा जानने के लिए, यहां देखें इसके लिए इंटरैक्टिव सुविधाओं की जांच करें Google Chat ऐप्लिकेशन.
समस्या हल करें
जब Google Chat ऐप्लिकेशन या card कोई गड़बड़ी दिखाता है, Chat के इंटरफ़ेस पर, "कोई गड़बड़ी हुई" मैसेज दिखता है. या "आपका अनुरोध प्रोसेस नहीं किया जा सका." कभी-कभी Chat यूज़र इंटरफ़ेस (यूआई) गड़बड़ी का कोई मैसेज नहीं दिखाता है. हालांकि, Chat ऐप्लिकेशन या कार्ड से कोई अनचाहा नतीजा मिलता है; उदाहरण के लिए, कार्ड मैसेज शायद दिखाना चाहते हैं.
हालांकि, Chat के यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी का मैसेज शायद न दिखे, गड़बड़ी ठीक करने में आपकी मदद करने के लिए, जानकारी देने वाले गड़बड़ी के मैसेज और लॉग डेटा उपलब्ध है जब चैट ऐप्लिकेशन के लिए गड़बड़ी लॉग करने की सेटिंग चालू हो. मदद के लिए, डीबग करने और गड़बड़ियां ठीक करने के लिए, देखें Google Chat से जुड़ी गड़बड़ियां हल करना और गड़बड़ियां ठीक करना.
व्यवस्थित करें
इसके लिए आपके Google Cloud खाते पर लगने वाले शुल्क से बचने के लिए तो हमारा सुझाव है कि आप Cloud प्रोजेक्ट शामिल है.
- Google Cloud Console में, संसाधन मैनेज करें पेज पर जाएं. क्लिक करें मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.
- प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे मिटाना है. इसके बाद, क्लिक करें मिटाएं .
- डायलॉग बॉक्स में, प्रोजेक्ट आईडी टाइप करें. इसके बाद, मिटाने के लिए शट डाउन करें पर क्लिक करें को भी शामिल किया है.
मिलते-जुलते विषय
अपने Chat ऐप्लिकेशन में ज़्यादा सुविधाएं जोड़ने के लिए, फ़ॉलो किया जा रहा है: