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

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

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

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

1. जब कोई उपयोगकर्ता, Chat ऐप्लिकेशन को मैसेज भेजता है, तो डायरेक्ट मैसेज या चैट स्पेस में.
2. Chat ऐप्लिकेशन का लॉजिक, जिसे Google Cloud में मौजूद Apps Script को अपडेट मिलता है और मैसेज को प्रोसेस करता है.
3. इसके अलावा, Chat ऐप्लिकेशन का लॉजिक Google Workspace की सेवाएं, जैसे कि Calendar या Sheets या Google की अन्य सेवाएं, जैसे कि Google Maps या YouTube.
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 में, मेन्यू पर जाएं > एपीआई और सेवाएं > OAuth की सहमति वाली स्क्रीन.

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

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

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

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

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

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

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

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

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

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

   IAM पर जाएं और एडमिन सेटिंग

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

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

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

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

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

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

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

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

1. Chat ऐप्लिकेशन के Apps Script प्रोजेक्ट में, डिप्लॉय करें पर क्लिक करें > टेस्ट डिप्लॉयमेंट.
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 ऐप्लिकेशन को टेस्ट करने के लिए, कोई डायरेक्ट मैसेज स्पेस खोलें चैट ऐप्लिकेशन खोलें और मैसेज भेजें:

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

   Google Chat पर जाएं

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

4. नतीजों में से Chat ऐप्लिकेशन चुनें. सीधे तौर पर होने वाला मैसेज खुलता है.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अगले चरण

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