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

इस पेज पर, Google Apps Script का इस्तेमाल करके, Google Workspace का ऐसा ऐड-ऑन बनाने का तरीका बताया गया है जो Google Chat में काम करता है.

ध्यान दें: Google Chat में, ऐड-ऑन उपयोगकर्ताओं को Google Chat ऐप्लिकेशन के तौर पर दिखते हैं. _Google Chat API के इंटरैक्शन इवेंट_ का इस्तेमाल करके भी, Chat ऐप्लिकेशन बनाया जा सकता है. ज़्यादा जानने के लिए, 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 में Chat ऐप्लिकेशन सेवा को जवाब भेजता है.
5. यह जवाब, उपयोगकर्ता को डिलीवर कर दिया जाता है.

मकसद

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

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

• Business या Enterprise Google Workspace खाता, जिसमें Google Chat का ऐक्सेस हो.
• Google Cloud प्रोजेक्ट. इसे बनाने के लिए, Google Cloud प्रोजेक्ट बनाना लेख पढ़ें.

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

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

अगर यह पहले से नहीं खुला है, तो वह 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 API Console में, मेन्यू > Google Auth प्लैटफ़ॉर्म > ब्रैंडिंग पर जाएं.

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

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. प्रोजेक्ट का टाइटल में, Add-on Chat app टाइप करें.

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

भविष्य में, अगर आपको Google के कुछ Google APIs इस्तेमाल करने हैं या अपना ऐप्लिकेशन पब्लिश करना है, तो आपको अपने क्लाउड प्रोजेक्ट को 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. ऐप्लिकेशन का नाम फ़ील्ड में, Add-on Chat app डालें.
   2. अवतार यूआरएल फ़ील्ड में, https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png डालें.
   3. जानकारी फ़ील्ड में, Add-on Chat 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 कॉन्फ़िगरेशन पेज की विज़िबिलिटी सेटिंग में, अपना 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. डायलॉग में, प्रोजेक्ट आईडी डालें. इसके बाद, प्रोजेक्ट को मिटाने के लिए, बंद करें पर क्लिक करें.