Google Apps Script Chat ऐप्लिकेशन क्विकस्टार्ट

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

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

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

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

मकसद

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

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

• आपके पास Google Workspace खाता हो, जिसमें Chat को ऐक्सेस करने की सुविधा हो.
• Google Cloud प्रोजेक्ट.

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

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

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

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

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

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

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

5. अपने ऐप्लिकेशन रजिस्ट्रेशन की खास जानकारी देखें. बदलाव करने के लिए, बदलाव करें पर क्लिक करें. अगर ऐप्लिकेशन रजिस्ट्रेशन ठीक लगता है, तो डैशबोर्ड पर वापस जाएं पर क्लिक करें.

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

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

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

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

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

1. Google Cloud Console में, मेन्यू menu > IAM और एडमिन > सेटिंग पर जाएं.

   आईएएम और एडमिन की सेटिंग पर जाएं

2. प्रोजेक्ट नंबर फ़ील्ड में जाकर, वैल्यू कॉपी करें.

Apps Script प्रोजेक्ट के लिए Cloud प्रोजेक्ट सेट करना

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

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

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

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

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

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

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

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

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

1. Google Cloud Console में, 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. डिप्लॉयमेंट आईडी फ़ील्ड में, वह हेड डिप्लॉयमेंट आईडी चिपकाएं जिसे आपने पहले कॉपी किया है.
   7. 'किसको दिखे' सेक्शन में जाकर, आपके डोमेन के खास लोग और ग्रुप को चुनें और अपना ईमेल पता डालें.

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

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

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

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

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

   Google Chat पर जाएं

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

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

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

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

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

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

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

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

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

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

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

   रिसोर्स मैनेजर पर जाएं

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

अगले चरण

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