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

इस पेज पर, Google Apps Script का इस्तेमाल करके Google Chat ऐप्लिकेशन बनाने का तरीका बताया गया है. 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 ऐप्लिकेशन की सेवा को वापस जवाब भेजता है.
5. जवाब को उपयोगकर्ता तक पहुंचाया जाता है.

मकसद

• अपना एनवायरमेंट सेट अप करें.
• स्क्रिप्ट सेट अप करें.
• Chat ऐप्लिकेशन को कॉन्फ़िगर करें.
• 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 platform > ब्रैंडिंग पर जाएं.

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

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 ऐड-ऑन के स्टार्टर पर जाएं. इसके बाद, Chat ऐप्लिकेशन टेंप्लेट पर क्लिक करें:

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

2. खुले हुए नए Apps Script प्रोजेक्ट में, प्रोजेक्ट का नाम डालें:

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

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

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

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

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

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

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

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

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

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

1. API Console में, Google Chat API खोजें. इसके बाद, Google Chat API पर क्लिक करें.
2. मैनेज करें पर क्लिक करें.

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

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

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

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

Chat ऐप्लिकेशन को आज़माना

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

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

   Google Chat पर जाएं

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

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

   ध्यान दें: अगर आपको नतीजों की सूची में Chat ऐप्लिकेशन नहीं दिख रहा है, तो पक्का करें कि आपने Google API Console में Chat API कॉन्फ़िगरेशन पेज की Visibility सेटिंग में अपना 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 ऐप्लिकेशन की मुख्य सुविधाओं के बारे में जान पाते हैं और उनका इस्तेमाल कर पाते हैं.
• डायलॉग लॉन्च करना–डायलॉग, विंडो वाले और कार्ड पर आधारित इंटरफ़ेस होते हैं. आपका ऐप्लिकेशन, उपयोगकर्ता से इंटरैक्ट करने के लिए इन्हें खोल सकता है. एक के बाद एक कई कार्ड दिखाए जा सकते हैं. इससे लोगों को कई चरणों वाली प्रोसेस पूरी करने में मदद मिलती है. जैसे, फ़ॉर्म में डेटा भरना.
• कोडलैब: क्या आपको ज़्यादा बेहतर चैट ऐप्लिकेशन बनाना है? कोडलैब से मिले सुझाव/राय Gemini की मदद से, Google Chat के लिए चैट ऐप्लिकेशन बनाना.

ऐसे चैट ऐप्लिकेशन जो ऐड-ऑन नहीं हैं: Google Apps Script की मदद से Google Chat ऐप्लिकेशन बनाना

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

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

1. Apps Script Getting Started पेज पर जाएं.
2. पेज पर सबसे ऊपर मौजूद, Chat App टेंप्लेट पर क्लिक करें.

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

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

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

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

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

एपीआई कंसोल से, 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/workspace/chat/images/quickstart-app-avatar.png डालें.
   4. ब्यौरा फ़ील्ड में, Quickstart app डालें.
   5. सुविधाएं में जाकर, स्पेस और ग्रुप बातचीत में शामिल हों को चुनें.
   6. कनेक्शन की सेटिंग में जाकर, Apps Script को चुनें.
   7. डिप्लॉयमेंट आईडी फ़ील्ड में, हेड डिप्लॉयमेंट आईडी चिपकाएं. यह वही आईडी होना चाहिए जिसे आपने पहले कॉपी किया था.
   8. दिखने की सेटिंग में जाकर, आपके डोमेन के चुनिंदा लोग और ग्रुप को चुनें. इसके बाद, अपना ईमेल पता डालें.

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