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. अगर आपने उपयोगकर्ता टाइप के लिए बाहरी उपयोगकर्ता को चुना है, तो टेस्ट उपयोगकर्ताओं को जोड़ें:
    1. टेस्ट उपयोगकर्ता में जाकर, उपयोगकर्ताओं को जोड़ें पर क्लिक करें.
    2. अपना ईमेल पता और टेस्ट के लिए अनुमति पा चुके किसी अन्य उपयोगकर्ता का ईमेल पता डालें. इसके बाद, सेव करें और जारी रखें पर क्लिक करें.
  6. अपने ऐप्लिकेशन रजिस्ट्रेशन की खास जानकारी देखें. बदलाव करने के लिए, बदलाव करें पर क्लिक करें. अगर ऐप्लिकेशन रजिस्ट्रेशन ठीक लग रहा है, तो डैशबोर्ड पर वापस जाएं पर क्लिक करें.

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

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

  5. कॉन्फ़िगरेशन पेज पर, ऐप्लिकेशन के स्टेटस में जाकर, स्टेटस को लाइव - उपयोगकर्ताओं के लिए उपलब्ध पर सेट करें.

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

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

Chat ऐप्लिकेशन को टेस्ट करें

  1. Chat खोलें.
  2. ऐप्लिकेशन में नया डायरेक्ट मैसेज भेजने के लिए, चैट शुरू करें > ऐप्लिकेशन ढूंढें पर क्लिक करें.
  3. ऐप्लिकेशन ढूंढें पेज पर, Quickstart App खोजें.
  4. Quickstart ऐप्लिकेशन के बगल में, चैट पर क्लिक करें.
  5. ऐप्लिकेशन वाले नए डायरेक्ट मैसेज में, Hello टाइप करें और enter दबाएं.

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

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

अगले चरण

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