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

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

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

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

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

मकसद

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

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

• आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
• Google Cloud प्रोजेक्ट. प्रोजेक्ट बनाने के लिए, 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. अपने ऐप्लिकेशन के रजिस्ट्रेशन की खास जानकारी देखें. बदलाव करने के लिए, बदलाव करें पर क्लिक करें. अगर ऐप्लिकेशन का रजिस्ट्रेशन ठीक है, तो डैशबोर्ड पर वापस जाएं पर क्लिक करें.

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

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

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

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 प्रोजेक्ट में, डिप्लॉय करें > डिप्लॉयमेंट की जांच करें पर क्लिक करें.
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. डिप्लॉयमेंट आईडी फ़ील्ड में, वह हेड डिप्लॉयमेंट आईडी चिपकाएं जिसे आपने पहले कॉपी किया था.
   7. 'दिखाई गई जानकारी' में जाकर, आपके डोमेन में मौजूद कुछ लोग और ग्रुप चुनें. इसके बाद, अपना ईमेल पता डालें.

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

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

Chat ऐप्लिकेशन की जांच करना

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

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

   Google Chat पर जाएं

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

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

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

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

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

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

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

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

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

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

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

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

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

अगले चरण

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