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

ऐसा Google Chat ऐप्लिकेशन बनाएं जिसे सीधे मैसेज किया जा सके और वह आपके मैसेज का जवाब दे.

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

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

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

मकसद

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

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

• Google Workspace खाता, जिसके पास Chat का ऐक्सेस हो.
• Google Cloud प्रोजेक्ट.

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

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

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

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 Cloud Console में, मेन्यू menu > एपीआई और सेवाएं > OAuth की सहमति वाली स्क्रीन पर जाएं.

   ऐसी स्क्रीन पर जाएं जहां OAuth के लिए सहमति दी जाती है

2. अपने ऐप्लिकेशन के लिए, उपयोगकर्ता का टाइप चुनें. इसके बाद, बनाएं पर क्लिक करें.
3. ऐप्लिकेशन रजिस्ट्रेशन फ़ॉर्म भरें. इसके बाद, सेव करें और जारी रखें पर क्लिक करें.

4. फ़िलहाल, स्कोप जोड़ने के बजाय, सेव करें और जारी रखें पर क्लिक करें. आने वाले समय में, जब आपको अपने Google Workspace संगठन से बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाना होगा, तो आपको अनुमति वाले ऐसे दायरे जोड़ने होंगे और उनकी पुष्टि करनी होगी जो आपके ऐप्लिकेशन के लिए ज़रूरी हैं.

5. अगर आपने उपयोगकर्ता टाइप के लिए बाहरी को चुना है, तो टेस्ट उपयोगकर्ताओं को जोड़ें:
   1. उपयोगकर्ताओं की जांच करें सेक्शन में, उपयोगकर्ता जोड़ें पर क्लिक करें.
   2. अपना ईमेल पता और कोई अन्य अनुमति पा चुके टेस्ट उपयोगकर्ता डालें. इसके बाद, सेव करें और जारी रखें पर क्लिक करें.
6. अपने ऐप्लिकेशन रजिस्ट्रेशन की खास जानकारी की समीक्षा करें. बदलाव करने के लिए, बदलाव करें पर क्लिक करें. अगर ऐप्लिकेशन रजिस्ट्रेशन ठीक लगता है, तो डैशबोर्ड पर वापस जाएं पर क्लिक करें.

स्क्रिप्ट सेट अप करें

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

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

1. ऐप्लिकेशन स्क्रिप्ट इस्तेमाल शुरू करना पेज पर जाएं.
2. Chat ऐप्लिकेशन टेंप्लेट पर क्लिक करें. इस टेंप्लेट को देखने के लिए, आपको नीचे स्क्रोल करना पड़ सकता है.
3. बिना टाइटल वाला प्रोजेक्ट पर क्लिक करें, Quickstart app टाइप करें, और नाम बदलें पर क्लिक करें.

Cloud प्रोजेक्ट नंबर कॉपी करें

1. Google Cloud Console में, अपने क्लाउड प्रोजेक्ट पर जाएं.
2. सेटिंग और उपयोगिताएं more_vert > प्रोजेक्ट सेटिंग पर क्लिक करें.
3. प्रोजेक्ट नंबर कॉपी करें.

Apps Script प्रोजेक्ट का क्लाउड प्रोजेक्ट सेट करें

1. Chat ऐप्लिकेशन के Apps Script प्रोजेक्ट में, प्रोजेक्ट सेटिंग पर क्लिक करें.
2. Google Cloud Platform (GCP) प्रोजेक्ट में जाकर, प्रोजेक्ट बदलें पर क्लिक करें.
3. GCP प्रोजेक्ट नंबर में, Google Cloud का प्रोजेक्ट नंबर चिपकाएं.
4. प्रोजेक्ट सेट करें पर क्लिक करें.

अब आपका ऐप्लिकेशन कोड काम कर रहा है. इसे आज़माकर (जैसा कि यहां दिया गया तरीका बताया गया है) किया जा सकता है और फिर अपनी ज़रूरत के हिसाब से इसे कस्टमाइज़ किया जा सकता है.

Apps Script टेंप्लेट खोलने पर, पक्का करें कि आपने सही Google खाते में साइन इन किया हो. चालू खाता कभी-कभी आपके डिफ़ॉल्ट खाते पर स्विच कर सकता है. इसके लिए, आपको उस पर ध्यान देने की ज़रूरत नहीं है.

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

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

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

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

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

Google Cloud Console से Chat ऐप्लिकेशन पब्लिश करें.

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

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

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

4. सेव करें पर क्लिक करें और पेज को रीफ़्रेश करें.

5. कॉन्फ़िगरेशन पेज पर, ऐप्लिकेशन के स्टेटस में जाकर, स्टेटस को लाइव - उपयोगकर्ताओं के लिए उपलब्ध पर सेट करें.

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

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

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

1. Chat खोलें.
2. चैट शुरू करें add > ऐप्लिकेशन ढूंढें पर क्लिक करके, ऐप्लिकेशन को नया डायरेक्ट मैसेज भेजें.
3. ऐप्लिकेशन ढूंढें पेज पर, Quickstart App खोजें.
4. क्विकस्टार्ट ऐप्लिकेशन के बगल में, चैट पर क्लिक करें.
5. ऐप्लिकेशन वाले नए डायरेक्ट मैसेज में, Hello टाइप करें और enter दबाएं.

ऐप्लिकेशन, इसे जोड़ने के लिए धन्यवाद देता है. साथ ही, आपके मैसेज का जवाब देता है.

अगले चरण

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