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

इस पेज पर, Google Apps Script का इस्तेमाल करके Google Chat ऐप्लिकेशन बनाने का तरीका बताया गया है. Chat ऐप्लिकेशन आपको सीधे मैसेज भेजने की सुविधा देता है. साथ ही, आपके मैसेज को दोहराकर जवाब देता है.

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

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

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

मकसद

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

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

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

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

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

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

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

   कोई क्लाउड प्रोजेक्ट चुनना

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 के शुरू करें पेज पर मौजूद Chat ऐप्लिकेशन टेंप्लेट का इस्तेमाल करें.

Apps Script प्रोजेक्ट बनाना

1. Apps Script के शुरू करें पेज पर, Google Workspace ऐड-ऑन के स्टार्टर पर जाएं और चैट ऐप्लिकेशन टेंप्लेट पर क्लिक करें:

   चैट ऐप्लिकेशन का टेंप्लेट खोलना

2. इसके बाद, Apps Script का एक नया प्रोजेक्ट खुलेगा. उसे यह नाम दें:

   1. बिना टाइटल वाला प्रोजेक्ट पर क्लिक करें.

   2. प्रोजेक्ट का टाइटल में, Quickstart app टाइप करें.

   3. नाम बदलें पर क्लिक करें.

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

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

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

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

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

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

Google Chat ऐप्लिकेशन को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:

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

3. Configuration पर क्लिक करें और Chat ऐप्लिकेशन सेट अप करें:

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

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

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

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

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

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

   Google Chat पर जाएं

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   संसाधन मैनेजर पर जाएं

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

अगले चरण

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

ऐड-ऑन के तौर पर काम न करने वाले चैट ऐप्लिकेशन: Google Apps Script की मदद से Google Chat ऐप्लिकेशन बनाना

अगर आपको Apps Script की मदद से ऐसा Chat ऐप्लिकेशन बनाना है जो Google Workspace ऐड-ऑन नहीं है, तो टेंप्लेट से स्क्रिप्ट बनाने और ऐड-ऑन के तौर पर काम न करने वाले Chat ऐप्लिकेशन को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं.

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

1. चैट ऐप्लिकेशन का टेंप्लेट खोलना

2. बिना टाइटल वाला प्रोजेक्ट पर क्लिक करें, Quickstart app टाइप करें, और नाम बदलें पर क्लिक करें.

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

3. चैट ऐप्लिकेशन के Apps Script प्रोजेक्ट में, डिप्लॉय करें > डिप्लॉयमेंट की जांच करें पर क्लिक करें.

4. अगले चरण में इस्तेमाल करने के लिए, हेड डिप्लॉयमेंट आईडी को कॉपी करें. इसके बाद, हो गया पर क्लिक करें.

ऐसे चैट ऐप्लिकेशन को कॉन्फ़िगर करना जो ऐड-ऑन नहीं है

API Console से, उस चैट ऐप्लिकेशन को कॉन्फ़िगर करें जो ऐड-ऑन नहीं है:

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

3. कॉन्फ़िगरेशन पर क्लिक करें और उस Chat ऐप्लिकेशन को सेट अप करें जो ऐड-ऑन नहीं है:

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

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