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

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

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

Apps Script की मदद से लागू किए गए Chat ऐप्लिकेशन का आर्किटेक्चर.

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

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

मकसद

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

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

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

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

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

  1. Google Cloud Console में, कोई प्रोजेक्ट चुनें पेज पर जाएं.

    Cloud प्रोजेक्ट चुनें

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

Chat API चालू करना

Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. किसी एक Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.

OAuth 2.0 का इस्तेमाल करने वाले सभी ऐप्लिकेशन के लिए, सहमति वाली स्क्रीन कॉन्फ़िगरेशन की ज़रूरत होती है. ऐप्लिकेशन की OAuth के लिए सहमति देने वाली स्क्रीन को कॉन्फ़िगर करने से, यह तय होता है कि उपयोगकर्ताओं और ऐप्लिकेशन के समीक्षकों को क्या दिखेगा. साथ ही, आपका ऐप्लिकेशन रजिस्टर किया जाता है, ताकि आप उसे बाद में पब्लिश कर सकें.

  1. Google Cloud Console में, मेन्यू > एपीआई और सेवाएं > OAuth की सहमति वाली स्क्रीन पर जाएं.

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

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

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

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

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

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

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

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

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

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

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

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

Apps Script प्रोजेक्ट का क्लाउड प्रोजेक्ट सेट करें

  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 Console में, Google Chat API खोजें और Google Chat API पर क्लिक करें.
  2. मैनेज करें पर क्लिक करें.

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

    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 Chat को उस Google Workspace खाते का इस्तेमाल करके खोलें जिसे आपने भरोसेमंद टेस्टर के तौर पर जोड़ते समय दिया था.

    Google Chat पर जाएं

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

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

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

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

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

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

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

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

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

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

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

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

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

अगले चरण

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