Pub/Sub की मदद से, फ़ायरवॉल से सुरक्षित Google Chat ऐप्लिकेशन बनाएं (original) (raw)

सीधे मुख्य कॉन्टेंट पर जाएं

इस पेज पर, Pub/Sub का इस्तेमाल करके Chat ऐप्लिकेशन बनाने का तरीका बताया गया है. Chat ऐप्लिकेशन के लिए इस तरह का आर्किटेक्चर तब काम का होता है, जब आपके संगठन के पास फ़ायरवॉल हो. इससे Chat, आपके Chat ऐप्लिकेशन को मैसेज नहीं भेज पाता. इसके अलावा, अगर Chat ऐप्लिकेशन,Google Workspace Events API का इस्तेमाल करता है, तब भी यह आर्किटेक्चर काम का होता है. हालांकि, इस आर्किटेक्चर की ये सीमाएं हैं, क्योंकि इस तरह के Chat ऐप्लिकेशन सिर्फ़ एसिंक्रोनस मैसेज भेज और पा सकते हैं:एसिंक्रोनस मैसेज

यहां दिए गए डायग्राम में, Pub/Sub की मदद से बनाए गए Chat ऐप्लिकेशन का आर्किटेक्चर दिखाया गया है:

Pub/Sub की मदद से लागू किए गए Chat ऐप्लिकेशन का आर्किटेक्चर.

ऊपर दिए गए डायग्राम में, Pub/Sub Chat ऐप्लिकेशन के साथ इंटरैक्ट करने वाले उपयोगकर्ता के लिए, जानकारी का फ़्लो इस तरह होता है:

  1. कोई उपयोगकर्ता, Chat ऐप्लिकेशन को Chat में मैसेज भेजता है. यह मैसेज, डायरेक्ट मैसेज या Chat स्पेस में भेजा जा सकता है. इसके अलावा, Chat स्पेस में कोई ऐसा इवेंट होता है जिसके लिए Chat ऐप्लिकेशन की सदस्यता चालू है.
  2. Chat, मैसेज को Pub/Sub विषय पर भेजता है.
  3. कोई ऐप्लिकेशन सर्वर, जो क्लाउड या ऑन-प्रिमाइसेस सिस्टम हो सकता है और जिसमें Chat ऐप्लिकेशन की लॉजिक शामिल होती है, फ़ायरवॉल के ज़रिए मैसेज पाने के लिए, Pub/Sub विषय की सदस्यता लेता है.
  4. Chat ऐप्लिकेशन के पास, Chat API को कॉल करके एसिंक्रोनस तरीके से मैसेज पोस्ट करने या अन्य कार्रवाइयां करने का विकल्प होता है.

ज़रूरी शर्तें

Chat ऐप्लिकेशन बनाते समय, Google Cloud Console में Chat API के कॉन्फ़िगरेशन पेज पर, इस Chat ऐप्लिकेशन को Google Workspace ऐड-ऑन के तौर पर बनाएं विकल्प को साफ़ करें. Google Chat पर ऐप्लिकेशन पब्लिश करना लेख पढ़ें.

Node.js

Python

Java

एनवायरमेंट सेट अप करना

Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. किसी एक Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.

Pub/Sub सेट अप करना

  1. कोई Pub/Sub विषय बनाएं, जिस पर Chat API मैसेज भेज सके. हमारा सुझाव है कि हर Chat ऐप्लिकेशन के लिए एक विषय का इस्तेमाल करें.
  2. Chat को पब्लिश करने की अनुमति देंविषय पर. इसके लिए, इस सेवा खाते को Pub/Sub पब्लिशर की भूमिका असाइन करें:
chat-api-push@system.gserviceaccount.com
  1. Chat ऐप्लिकेशन के लिए कोई सेवा खाता बनाएं, ताकि Pub/Sub और Chat के साथ अनुमति दी जा सके. इसके बाद, निजी पासकोड वाली फ़ाइल को अपनी वर्किंग डायरेक्ट्री में सेव करें.
  2. विषय के लिए, पुल सदस्यता बनाएं.
  3. पहले बनाए गए सेवा खाते के लिए, सदस्यता पर Pub/Sub सदस्य की भूमिका असाइन करें.

स्क्रिप्ट लिखना

Node.js

  1. किसी सीएलआई में, सेवा खाते के क्रेडेंशियल दें:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
  1. किसी सीएलआई में, Google Cloud प्रोजेक्ट आईडी दें:
export PROJECT_ID=PROJECT_ID
  1. किसी सीएलआई में, पहले बनाई गई Pub/Sub सदस्यता के लिए सदस्यता आईडी दें:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
  1. अपनी वर्किंग डायरेक्ट्री में, package.json नाम की कोई फ़ाइल बनाएं.
  2. package.json फ़ाइल में, यह कोड चिपकाएं:
  3. अपनी वर्किंग डायरेक्ट्री में, index.js नाम की कोई फ़ाइल बनाएं.
  4. index.js में, यह कोड चिपकाएं:

Python

  1. किसी सीएलआई में, सेवा खाते के क्रेडेंशियल दें:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
  1. किसी सीएलआई में, Google Cloud प्रोजेक्ट आईडी दें:
export PROJECT_ID=PROJECT_ID
  1. किसी सीएलआई में, पहले बनाई गई Pub/Sub सदस्यता के लिए सदस्यता आईडी दें:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
  1. अपनी वर्किंग डायरेक्ट्री में, requirements.txt नाम की कोई फ़ाइल बनाएं.
  2. requirements.txt फ़ाइल में, यह कोड चिपकाएं:
  3. अपनी वर्किंग डायरेक्ट्री में, app.py नाम की कोई फ़ाइल बनाएं.
  4. app.py में, यह कोड चिपकाएं:

Java

  1. किसी सीएलआई में, सेवा खाते के क्रेडेंशियल दें:
export GOOGLE_APPLICATION_CREDENTIALS=SERVICE_ACCOUNT_FILE_PATH
  1. किसी सीएलआई में, Google Cloud प्रोजेक्ट आईडी दें:
export PROJECT_ID=PROJECT_ID
  1. किसी सीएलआई में, पहले बनाई गई Pub/Sub सदस्यता के लिए सदस्यता आईडी दें:
export SUBSCRIPTION_ID=SUBSCRIPTION_ID
  1. अपनी वर्किंग डायरेक्ट्री में, pom.xml नाम की कोई फ़ाइल बनाएं.
  2. pom.xml फ़ाइल में, यह कोड चिपकाएं:
  3. अपनी वर्किंग डायरेक्ट्री में, src/main/java डायरेक्ट्री स्ट्रक्चर बनाएं.
  4. src/main/java डायरेक्ट्री में, Main.java नाम की कोई फ़ाइल बनाएं.
  5. Main.java में, यह कोड चिपकाएं:

Chat पर ऐप्लिकेशन पब्लिश करना

  1. Google Cloud Console में, मेन्यू> एपीआई और सेवाएं> चालू किए गए एपीआई और सेवाएं> Google Chat API> कॉन्फ़िगरेशन पर जाएं.
    कॉन्फ़िगरेशन पर जाएं
  2. Pub/Sub के लिए Chat ऐप्लिकेशन कॉन्फ़िगर करें:
    1. इस Chat ऐप्लिकेशन को Google Workspace ऐड-ऑन के तौर पर बनाएं विकल्प को साफ़ करें. आपको पुष्टि करने के लिए कहा जाएगा. इसके लिए, एक डायलॉग खुलेगा. डायलॉग में, बंद करें पर क्लिक करें.
    2. ऐप्लिकेशन का नाम में, Quickstart App डालें.
    3. अवतार यूआरएल में, https://developers.google.com/chat/images/quickstart-app-avatar.png डालें.
    4. **जानकारी** में, Quickstart app डालें.
    5. सुविधाएं में जाकर, स्पेस और ग्रुप बातचीत में शामिल हों को चुनें.
    6. कनेक्शन सेटिंग में जाकर, Cloud Pub/Sub को चुनें. इसके बाद, पहले बनाए गए Pub/Sub विषय का नाम चिपकाएं.
    7. उपलब्धता में जाकर, अपने डोमेन में इस Google Chat ऐप्लिकेशन को चुनिंदा लोगों और ग्रुप के लिए उपलब्ध कराएं को चुनें. इसके बाद, अपना ईमेल पता डालें.
    8. लॉग में जाकर, लॉगिंग में गड़बड़ियां लॉग करें को चुनें.
  3. सेव करें पर क्लिक करें.

ऐप्लिकेशन, Chat पर मैसेज पाने और उनका जवाब देने के लिए तैयार है.

स्क्रिप्ट चलाना

किसी सीएलआई में, अपनी वर्किंग डायरेक्ट्री में स्विच करें और स्क्रिप्ट चलाएं:

Node.js

npm install
npm start

Python

python -m venv env
source env/bin/activate
pip install -r requirements.txt -U
python app.py

Java

mvn compile exec:java -Dexec.mainClass=Main

कोड चलाने पर, ऐप्लिकेशन उस Pub/Sub विषय पर पब्लिश किए गए मैसेज सुनने लगता है.

अपने Chat ऐप्लिकेशन की जांच करना

अपने Chat ऐप्लिकेशन की जांच करने के लिए, Chat ऐप्लिकेशन के साथ डायरेक्ट मैसेज वाला स्पेस खोलें और कोई मैसेज भेजें:

  1. Google Workspace खाते का इस्तेमाल करके Google Chat खोलें. यह वही खाता होना चाहिए जिसे आपने भरोसेमंद टेस्टर के तौर पर खुद को जोड़ते समय दिया था.
    Google Chat पर जाएं
  2. नई चैट पर क्लिक करें.
  3. एक या उससे ज़्यादा लोगों को जोड़ें फ़ील्ड में, अपने Chat ऐप्लिकेशन का नाम डालें.
  4. नतीजों में से अपना Chat ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलता है.
  5. ऐप्लिकेशन के साथ नए डायरेक्ट मैसेज में, Hello लिखें और enter दबाएं.

भरोसेमंद टेस्टर जोड़ने और इंटरैक्टिव सुविधाओं की जांच करने के बारे में ज़्यादा जानने के लिए, Google Chat ऐप्लिकेशन के लिए इंटरैक्टिव सुविधाओं की जांच करना लेख पढ़ें.

समस्या हल करें

जब कोई Google Chat ऐप्लिकेशन याकार्ड गड़बड़ी दिखाता है, तो Chat इंटरफ़ेस पर "कोई गड़बड़ी हुई" मैसेज दिखता है. या "आपका अनुरोध प्रोसेस नहीं किया जा सका." कभी-कभी Chat यूज़र इंटरफ़ेस (यूआई) पर कोई गड़बड़ी का मैसेज नहीं दिखता, लेकिन Chat ऐप्लिकेशन या कार्ड से कोई ऐसा नतीजा मिलता है जिसकी उम्मीद नहीं थी. उदाहरण के लिए, हो सकता है कि कोई कार्ड मैसेज न दिखे.

भले ही, Chat यूआई में कोई गड़बड़ी का मैसेज न दिखे, लेकिन Chat ऐप्लिकेशन के लिए गड़बड़ी लॉग करने की सुविधा चालू होने पर, गड़बड़ियों को ठीक करने में आपकी मदद करने के लिए, गड़बड़ी के बारे में जानकारी देने वाले मैसेज और लॉग डेटा उपलब्ध होता है. गड़बड़ियां देखने, डीबग करने, और ठीक करने में मदद पाने के लिए, Google Chat की गड़बड़ियां ठीक करना लेख पढ़ें.

व्यवस्थित करें

हमारा सुझाव है कि इस ट्यूटोरियल में इस्तेमाल किए गए संसाधनों के लिए, अपने Google Cloud खाते पर शुल्क लगने से बचने के लिए, क्लाउड प्रोजेक्ट मिटा दें.

  1. Google Cloud Console में, संसाधन मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.
    Resource Manager पर जाएं
  2. प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे आपको मिटाना है. इसके बाद,मिटाएं पर क्लिक करें.
  3. डायलॉग में, प्रोजेक्ट आईडी डालें. इसके बाद, प्रोजेक्ट मिटाने के लिए बंद करें पर क्लिक करें.

जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.

आखिरी बार 2026-04-01 (UTC) को अपडेट किया गया.