Google Apps Script की मदद से, Google Chat ऐप्लिकेशन बनाना

ध्यान दें: इस गाइड में, इंटरैक्टिव Chat ऐप्लिकेशन बनाने का तरीका बताया गया है जिसमें Chat API के इंटरैक्शन इवेंट का इस्तेमाल किया गया है. Chat ऐप्लिकेशन को Google Workspace ऐड-ऑन के तौर पर भी बनाया जा सकता है. कौनसा फ़्रेमवर्क इस्तेमाल करना है, यह जानने के लिए, इंटरैक्टिव Google Chat ऐप्लिकेशन बनाना लेख पढ़ें.

ऐसा Google Chat ऐप्लिकेशन बनाएं जिसे डायरेक्ट मैसेज भेजा जा सके और जो आपके मैसेज को वापस भेजकर जवाब दे.

नीचे दिए गए डायग्राम में, आर्किटेक्चर और मैसेजिंग पैटर्न दिखाया गया है:

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

1. कोई उपयोगकर्ता, Chat ऐप्लिकेशन को डायरेक्ट मैसेज या Chat स्पेस में मैसेज भेजता है.
2. Apps Script में लागू किया गया Chat ऐप्लिकेशन लॉजिक, जो Google Cloud में मौजूद होता है, मैसेज को रिसीव और प्रोसेस करता है.
3. Chat ऐप्लिकेशन लॉजिक, Google Workspace की सेवाओं के साथ इंटिग्रेट हो सकता है. जैसे, Calendar या Sheets. इसके अलावा, यह Google की अन्य सेवाओं के साथ भी इंटिग्रेट हो सकता है. जैसे, Google Maps या YouTube.
4. Chat ऐप्लिकेशन लॉजिक, Chat में Chat ऐप्लिकेशन सेवा को वापस जवाब भेजता है.
5. जवाब, उपयोगकर्ता को डिलीवर कर दिया जाता है.

मकसद

• अपना एनवायरमेंट सेट अप करना.
• स्क्रिप्ट सेट अप करना.
• Chat ऐप्लिकेशन को कॉन्फ़िगर करना.
• Chat ऐप्लिकेशन को टेस्ट करना.

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

• Business या Enterprise Google Workspace खाता, जिसमें Google Chat का ऐक्सेस हो.
• एक Google Cloud प्रोजेक्ट. इसे बनाने के लिए, Google Cloud प्रोजेक्ट बनाना लेख पढ़ें.

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

Google Cloud Console में अपना क्लाउड प्रोजेक्ट खोलना

अगर यह पहले से खुला नहीं है, तो वह क्लाउड प्रोजेक्ट खोलें जिसका इस्तेमाल आपको इस सैंपल के लिए करना है:

1. Google Cloud Console में, कोई प्रोजेक्ट चुनें पेज पर जाएं.

   कोई Cloud प्रोजेक्ट चुनें

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

Chat API चालू करना

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

• Google Cloud Console में, Google Chat API चालू करें.

  एपीआई चालू करना

उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth को सहमति दी जाती है

OAuth 2.0 का इस्तेमाल करने वाले सभी ऐप्लिकेशन के लिए, सहमति की स्क्रीन का कॉन्फ़िगरेशन ज़रूरी है. अपने ऐप्लिकेशन की OAuth सहमति स्क्रीन को कॉन्फ़िगर करने से, यह तय होता है कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वालों को क्या दिखेगा. साथ ही, इससे आपका ऐप्लिकेशन रजिस्टर हो जाता है, ताकि उसे बाद में पब्लिश किया जा सके.

1. Google API Console में, मेन्यू > Google Auth प्लैटफ़ॉर्म > ब्रैंडिंग पर जाएं.

   ब्रैंडिंग पर जाएं

2. अगर आपने Google Auth प्लैटफ़ॉर्म को पहले ही कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, दर्शक, और डेटा ऐक्सेस में, OAuth सहमति स्क्रीन की ये सेटिंग कॉन्फ़िगर की जा सकती हैं. अगर आपको Google Auth प्लैटफ़ॉर्म को अब तक कॉन्फ़िगर नहीं किया गया है मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
1. ऐप्लिकेशन की जानकारी में, ऐप्लिकेशन का नाम में जाकर, ऐप्लिकेशन के लिए कोई नाम डालें.
2. उपयोगकर्ता सहायता ईमेल में जाकर, सहायता के लिए कोई ईमेल पता चुनें. इस पते पर, उपयोगकर्ता अपनी सहमति के बारे में सवाल पूछ सकते हैं.
3. आगे बढ़ें पर क्लिक करें.
4. दर्शक में जाकर, इंटरनल को चुनें.
5. आगे बढ़ें पर क्लिक करें.
6. संपर्क जानकारी में जाकर, ईमेल पता डालें. इस पते पर, आपको अपने प्रोजेक्ट में किए गए किसी भी बदलाव के बारे में सूचना मिल सकती है.
7. आगे बढ़ें पर क्लिक करें.
8. पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति की समीक्षा करें. अगर आपको यह नीति स्वीकार है, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति से सहमत हूं को चुनें.
9. जारी रखें पर क्लिक करें.
10. बनाएं पर क्लिक करें.
3. फ़िलहाल, स्कोप जोड़ने के चरण को छोड़ा जा सकता है. भविष्य में, जब Google Workspace संगठन के बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाया जाता है, तो आपको उपयोगकर्ता का टाइप बदलकर एक्सटर्नल करना होगा. इसके बाद, अनुमति के वे स्कोप जोड़ें जिनकी आपके ऐप्लिकेशन को ज़रूरत है. ज़्यादा जानने के लिए, OAuth सहमति को कॉन्फ़िगर करने की पूरी गाइड देखें.

स्क्रिप्ट सेट अप करना

स्क्रिप्ट सेट अप करने के लिए, किसी टेंप्लेट का इस्तेमाल करें. इसके बाद, Apps Script में अपना क्लाउड प्रोजेक्ट सेट करें.

टेंप्लेट से स्क्रिप्ट बनाना

1. Apps स्क्रिप्ट के शुरू करें पेज पर जाएं.
2. पेज पर सबसे ऊपर मौजूद, Chat ऐप्लिकेशन टेंप्लेट पर क्लिक करें.
3. बिना टाइटल वाला प्रोजेक्ट पर क्लिक करें, Quickstart app टाइप करें, और नाम बदलें पर क्लिक करें.

भविष्य में, अगर आपको Google के कुछ Google APIs का इस्तेमाल करना है या अपना ऐप्लिकेशन पब्लिश करना है, तो आपको अपने क्लाउड प्रोजेक्ट को Apps Script प्रोजेक्ट से जोड़ना होगा. इस गाइड के लिए, आपको ऐसा करने की ज़रूरत नहीं है. ज़्यादा जानने के लिए, Google Cloud प्रोजेक्ट की गाइड देखें.

टेस्ट डिप्लॉयमेंट बनाना

इस Apps स्क्रिप्ट प्रोजेक्ट के लिए, आपको डिप्लॉयमेंट आईडी की ज़रूरत होगी, ताकि अगले चरण में इसका इस्तेमाल किया जा सके.

हेड डिप्लॉयमेंट आईडी पाने के लिए, यह तरीका अपनाएं:

1. Chat ऐप्लिकेशन के Apps स्क्रिप्ट प्रोजेक्ट में, डिप्लॉय करें > टेस्ट डिप्लॉयमेंट पर क्लिक करें.
2. हेड डिप्लॉयमेंट आईडी को कॉपी करें, ताकि इसका इस्तेमाल अगले चरण में किया जा सके. इसके बाद, हो गया पर क्लिक करें.

Chat ऐप्लिकेशन को कॉन्फ़िगर करना

API Console से, Chat ऐप्लिकेशन को कॉन्फ़िगर करें.

1. API Console में, खोजें, Google Chat API और Google Chat API पर क्लिक करें.
2. मैनेज करें पर क्लिक करें.

3. कॉन्फ़िगरेशन पर क्लिक करें और Chat ऐप्लिकेशन सेट अप करें:

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

4. सेव करें पर क्लिक करें.

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

Chat ऐप्लिकेशन को टेस्ट करना

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

1. Google Workspace खाते का इस्तेमाल करके, Google Chat खोलें. आपने इस खाते की जानकारी, भरोसेमंद टेस्टर के तौर पर खुद को जोड़ने के दौरान दी थी.

   Google Chat खोलें

2. नई चैट पर क्लिक करें.
3. एक या उससे ज़्यादा लोग जोड़ें फ़ील्ड में, अपने Chat ऐप्लिकेशन का नाम डालें.

4. नतीजों में से अपना Chat ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलता है.

   ध्यान दें: अगर आपको नतीजों की सूची में अपना Chat ऐप्लिकेशन नहीं दिखता है, तो पक्का करें कि आपने Google API Console में Chat API कॉन्फ़िगरेशन पेज की विज़िबिलिटी सेटिंग में, अपना Google Workspace खाता शामिल किया हो.

5. ऐप्लिकेशन के साथ नए डायरेक्ट मैसेज में, Hello टाइप करें और enter दबाएं.

   Chat ऐप्लिकेशन, आपको उसे जोड़ने के लिए धन्यवाद देता है और आपके मैसेज को वापस भेजता है.

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

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

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

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

स्टोरेज में जगह बनाएं

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

चेतावनी: किसी प्रोजेक्ट को मिटाने पर, ये असर पड़ते हैं:

• प्रोजेक्ट में मौजूद हर चीज़ मिट जाती है. अगर आपने इस ट्यूटोरियल के लिए किसी मौजूदा प्रोजेक्ट का इस्तेमाल किया है, तो उसे मिटाने पर, प्रोजेक्ट में किया गया आपका अन्य काम भी मिट जाता है.
• पसंद के मुताबिक बनाए गए प्रोजेक्ट आईडी मिट जाते हैं. इस प्रोजेक्ट को बनाते समय, आपने पसंद के मुताबिक कोई प्रोजेक्ट आईडी बनाया होगा, जिसका इस्तेमाल आपको भविष्य में करना है. प्रोजेक्ट आईडी का इस्तेमाल करने वाले यूआरएल को सेव करने के लिए, जैसे कि appspot.com पर मौजूद कोई यूआरएल, पूरे प्रोजेक्ट को मिटाने के बजाय, प्रोजेक्ट में चुने गए संसाधनों को मिटाएं.

अगर आपको एक से ज़्यादा ट्यूटोरियल और क्विकस्टार्ट आज़माने हैं, तो प्रोजेक्ट को दोबारा इस्तेमाल करने से, प्रोजेक्ट कोटा की सीमा से ज़्यादा इस्तेमाल करने से बचा जा सकता है.

1. Google API Console में, संसाधन मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.

   Resource Manager पर जाएं

2. प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे आपको मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
3. डायलॉग में, प्रोजेक्ट आईडी डालें. इसके बाद, प्रोजेक्ट को मिटाने के लिए बंद करें पर क्लिक करें.

अगले चरण

• इंटरैक्टिव कार्ड बनाना–कार्ड मैसेज में, तय किया गया लेआउट, इंटरैक्टिव यूज़र इंटरफ़ेस (यूआई) एलिमेंट (जैसे, बटन) और रिच मीडिया (जैसे, इमेज) शामिल किए जा सकते हैं. कार्ड मैसेज का इस्तेमाल करके, ज़्यादा जानकारी दी जा सकती है, उपयोगकर्ताओं से जानकारी इकट्ठा की जा सकती है, और उपयोगकर्ताओं को अगला चरण लेने के लिए गाइड किया जा सकता है.
• कमांड के जवाब देना–कमांड की मदद से, उपयोगकर्ता आपके Chat ऐप्लिकेशन की मुख्य सुविधाओं को खोज सकते हैं और उनका इस्तेमाल कर सकते हैं.
• डायलॉग लॉन्च करना–डायलॉग, विंडो वाले, कार्ड पर आधारित इंटरफ़ेस होते हैं. आपका ऐप्लिकेशन, उपयोगकर्ता के साथ इंटरैक्ट करने के लिए इन्हें खोल सकता है. एक के बाद एक कई कार्ड जोड़े जा सकते हैं. इससे उपयोगकर्ताओं को कई चरणों वाली प्रोसेस पूरी करने में मदद मिलती है. जैसे, फ़ॉर्म का डेटा भरना.
• Codelab: क्या आपको ज़्यादा बेहतर Chat ऐप्लिकेशन बनाना है? Codelab Gemini की मदद से, Google Chat के लिए ऐप्लिकेशन बनाना में, सुझाव/राय देने या शिकायत करने वाले Chat ऐप्लिकेशन के बारे में जानें.