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

डेवलपर प्रीव्यू: Google Workspace डेवलपर प्रीव्यू प्रोग्राम के हिस्से के रूप में उपलब्ध है, जो कुछ सुविधाओं तक समय से पहले पहुंच प्रदान करता है.

इस पेज पर, Google Apps Script का इस्तेमाल करके, Google Chat में काम करने वाला Google Workspace ऐड-ऑन बनाने का तरीका बताया गया है. Google Chat में, ऐड-ऑन उपयोगकर्ताओं को Google Chat ऐप्लिकेशन के तौर पर दिखते हैं. ज़्यादा जानने के लिए, Google Chat के एक्सटेंशन के बारे में खास जानकारी देखें.

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 ऐप्लिकेशन के लिए, Google Workspace ऐड-ऑन कॉन्फ़िगर करें.
• Chat ऐप्लिकेशन को टेस्ट करें.

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

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

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

2. अगर आपने पहले से ही को कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, ऑडियंस, और डेटा ऐक्सेस में जाकर, OAuth सहमति स्क्रीन की ये सेटिंग कॉन्फ़िगर की जा सकती हैं. अगर आपको अभी तक कॉन्फ़िगर नहीं किया गया मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
1. ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में ऐप्लिकेशन का नाम डालें.
2. उपयोगकर्ता सहायता ईमेल में, सहायता पाने के लिए कोई ईमेल पता चुनें. अगर उपयोगकर्ताओं को अपनी सहमति के बारे में कोई सवाल पूछना है, तो वे आपसे इस पते पर संपर्क कर सकते हैं.
3. आगे बढ़ें पर क्लिक करें.
4. ऑडियंस सेक्शन में जाकर, इंटरनल चुनें.
5. आगे बढ़ें पर क्लिक करें.
6. संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव के बारे में सूचना दी जा सके.
7. आगे बढ़ें पर क्लिक करें.
8. पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा की नीति पढ़ें. अगर आप सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा की नीति से सहमत हूं को चुनें.
9. जारी रखें पर क्लिक करें.
10. बनाएं पर क्लिक करें.
3. फ़िलहाल, स्कोप जोड़ने की प्रोसेस को छोड़ा जा सकता है. आने वाले समय में, जब आप अपने Google Workspace संगठन के बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाएं, तो आपको उपयोगकर्ता टाइप को बाहरी पर सेट करना होगा. इसके बाद, अनुमति के ऐसे स्कोप जोड़ें जिनकी आपके ऐप्लिकेशन को ज़रूरत है. ज़्यादा जानने के लिए, OAuth की सहमति कॉन्फ़िगर करने से जुड़ी पूरी गाइड देखें.

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

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

क्विक स्टार्ट प्रोजेक्ट की कॉपी बनाना

1. Google Chat में ऐड-ऑन वाला Apps Script प्रोजेक्ट खोलने के लिए, नीचे दिए गए बटन पर क्लिक करें.
   प्रोजेक्ट खोलना
2. खास जानकारी पर क्लिक करें.
3. खास जानकारी वाले पेज पर, कॉपी बनाएं पर क्लिक करें.

4. Apps Script प्रोजेक्ट की कॉपी का नाम डालें:

   1. ऐड-ऑन चैट ऐप्लिकेशन की कॉपी पर क्लिक करें.

   2. प्रोजेक्ट का टाइटल में, Add-on Chat app टाइप करें

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

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

1. Google Cloud console में, मेन्यू > 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. बाद के चरण में इस्तेमाल करने के लिए, हेड डिप्लॉयमेंट आईडी को कॉपी करें और हो गया पर क्लिक करें.

ऐड-ऑन कॉन्फ़िगर करना

Apps Script डिप्लॉयमेंट का इस्तेमाल करके, ऐड-ऑन बनाने और Google Chat ऐप्लिकेशन को डिप्लॉय करने के लिए, यह तरीका अपनाएं:

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

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

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

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

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

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

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

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

   Google Chat पर जाएं

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

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

   ध्यान दें: अगर आपको नतीजों की सूची में अपना Chat ऐप्लिकेशन नहीं दिख रहा है, तो पक्का करें कि आपने Google Cloud 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 Cloud Console में, संसाधन मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.

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

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