इस ट्यूटोरियल में, Google Chat ऐप्लिकेशन बनाने का तरीका बताया गया है. इससे Google Chat के उपयोगकर्ताओं को अपने निजी और कारोबार से जुड़े संपर्कों को मैनेज करने में मदद मिलती है. जानकारी इकट्ठा करने के लिए, Chat ऐप्लिकेशन उपयोगकर्ताओं को कार्ड मैसेज और डायलॉग में संपर्क फ़ॉर्म भरने के लिए कहता है.
Chat ऐप्लिकेशन को इस्तेमाल करने का तरीका देखें:
-
पहली इमेज. Chat ऐप्लिकेशन, स्लैश कमांड /about
का जवाब एक टेक्स्ट मैसेज और बटन के साथ देता है. यह बटन, संपर्क फ़ॉर्म खोलता है. -
दूसरी इमेज. Chat ऐप्लिकेशन, एक डायलॉग बॉक्स खोलता है. इसमें उपयोगकर्ता, किसी संपर्क की जानकारी डाल सकते हैं. -
तीसरी इमेज. Chat ऐप्लिकेशन, पुष्टि करने वाला डायलॉग बॉक्स दिखाता है, ताकि उपयोगकर्ता सबमिट करने से पहले, जानकारी की समीक्षा कर सकें और उसकी पुष्टि कर सकें. -
चौथी इमेज. उपयोगकर्ता के फ़ॉर्म सबमिट करने के बाद, Chat ऐप्लिकेशन उसे एक निजी मैसेज भेजता है. इस मैसेज से, फ़ॉर्म सबमिट होने की पुष्टि की जाती है. -
पांचवीं इमेज. Chat ऐप्लिकेशन, उपयोगकर्ताओं को मैसेज में कार्ड से संपर्क जोड़ने के लिए भी कहता है.
ज़रूरी शर्तें
- आपके पास Google Chat का ऐक्सेस हो और आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो.
मकसद
card
ऑब्जेक्ट के तौर पर, यूज़र इंटरफ़ेस (यूआई) डिज़ाइन और बनाएं और मैसेज और डायलॉग में यूआई दिखाएं.- फ़ॉर्म इनपुट विजेट का इस्तेमाल करके, उपयोगकर्ताओं की सबमिट की गई जानकारी पाना और उसे प्रोसेस करना.
- टेक्स्ट, कार्ड, और ऐक्सेसरी विजेट वाले मैसेज भेजकर, स्लैश निर्देशों का जवाब दें.
आर्किटेक्चर
Chat ऐप्लिकेशन, Google Apps Script में बनाया गया है. यह Chat के उपयोगकर्ताओं के मैसेज को प्रोसेस करने और उनका जवाब देने के लिए, इंटरैक्शन इवेंट का इस्तेमाल करता है.
इस इमेज में दिखाया गया है कि आम तौर पर, कोई उपयोगकर्ता Chat ऐप्लिकेशन के साथ कैसे इंटरैक्ट कर सकता है:
कोई उपयोगकर्ता, Chat ऐप्लिकेशन में कोई डायरेक्ट मैसेज खोलता है या किसी मौजूदा स्पेस में Chat ऐप्लिकेशन जोड़ता है.
Chat ऐप्लिकेशन, उपयोगकर्ता को संपर्क जोड़ने के लिए कहता है. इसके लिए, वह संपर्क फ़ॉर्म बनाकर उसे
card
ऑब्जेक्ट के तौर पर दिखाता है. संपर्क फ़ॉर्म दिखाने के लिए, Chat ऐप्लिकेशन उपयोगकर्ताओं को इन तरीकों से जवाब देता है:- @नाम टैग करने और डायरेक्ट मैसेज का जवाब, कार्ड मैसेज के ज़रिए देता है. इसमें संपर्क फ़ॉर्म होता है.
- स्लैश कमांड
/addContact
का जवाब, संपर्क फ़ॉर्म वाला डायलॉग बॉक्स खोलकर देता है. - स्लैश कमांड
/about
का जवाब, टेक्स्ट मैसेज के ज़रिए देता है. इस मैसेज में, संपर्क जोड़ें बटन होता है. इस बटन पर क्लिक करके, उपयोगकर्ता संपर्क फ़ॉर्म वाला डायलॉग बॉक्स खोल सकते हैं.
संपर्क फ़ॉर्म दिखाए जाने पर, उपयोगकर्ता इन फ़ील्ड और विजेट में संपर्क जानकारी डालता है:
- नाम और सरनेम: स्ट्रिंग स्वीकार करने वाला ऐसा
textInput
विजेट. - जन्म की तारीख: यह एक ऐसा
dateTimePicker
विजेट है जिसमें सिर्फ़ तारीखें डाली जा सकती हैं. - संपर्क का टाइप: रेडियो बटन का ऐसा
selectionInput
विजेट जिसकी मदद से उपयोगकर्ता, एक स्ट्रिंग वैल्यू (Personal
याWork
) चुनकर सबमिट कर सकते हैं. - देखें और सबमिट करें बटन:
button
विजेट वाला एकbuttonList
ऐरे, जिस पर उपयोगकर्ता अपनी डाली गई वैल्यू सबमिट करने के लिए क्लिक करता है.
- नाम और सरनेम: स्ट्रिंग स्वीकार करने वाला ऐसा
Google Chat ऐप्लिकेशन, उपयोगकर्ता के इनपुट की वैल्यू को प्रोसेस करने के लिए,
CARD_CLICKED
इंटरैक्शन इवेंट को मैनेज करता है. साथ ही, पुष्टि करने वाले कार्ड में वैल्यू दिखाता है.उपयोगकर्ता, पुष्टि करने वाले कार्ड की समीक्षा करता है और संपर्क जानकारी को फ़ाइनल करने के लिए, सबमिट करें बटन पर क्लिक करता है.
Google Chat ऐप्लिकेशन, सबमिट किए गए अनुरोध की पुष्टि करने के लिए, एक निजी मैसेज भेजता है.
एनवायरमेंट तैयार करना
इस सेक्शन में, Chat ऐप्लिकेशन के लिए Google Cloud प्रोजेक्ट बनाने और उसे कॉन्फ़िगर करने का तरीका बताया गया है.
Google Cloud प्रोजेक्ट बनाना
Google Cloud कंसोल
- Google Cloud console में, मेन्यू > IAM और एडमिन > प्रोजेक्ट बनाएं पर जाएं.
-
प्रोजेक्ट का नाम फ़ील्ड में, अपने प्रोजेक्ट के लिए जानकारी देने वाला कोई नाम डालें.
ज़रूरी नहीं: प्रोजेक्ट आईडी में बदलाव करने के लिए, बदलाव करें पर क्लिक करें. प्रोजेक्ट बनाने के बाद, उसका आईडी नहीं बदला जा सकता. इसलिए, ऐसा आईडी चुनें जो प्रोजेक्ट के पूरे जीवनकाल के लिए आपकी ज़रूरतों को पूरा करता हो.
- अपने प्रोजेक्ट के लिए संभावित जगहें दिखाने के लिए, जगह फ़ील्ड में, ब्राउज़ करें पर क्लिक करें. इसके बाद, चुनें पर क्लिक करें.
- बनाएं पर क्लिक करें. Google Cloud Console, डैशबोर्ड पेज पर ले जाता है और कुछ ही मिनटों में आपका प्रोजेक्ट बन जाता है.
gcloud सीएलआई
नीचे दिए गए डेवलपमेंट एनवायरमेंट में से किसी एक में, Google Cloud
सीएलआई (gcloud
) को ऐक्सेस करें:
-
Cloud Shell: पहले से सेट अप किए गए gcloud सीएलआई के साथ ऑनलाइन टर्मिनल का इस्तेमाल करने के लिए, Cloud Shell को चालू करें.
Cloud Shell चालू करना -
लोकल शेल: लोकल डेवलपमेंट एनवायरमेंट का इस्तेमाल करने के लिए, gcloud सीएलआई को इंस्टॉल और इनिटिलाइज़ करें.
Cloud प्रोजेक्ट बनाने के लिए,gcloud projects create
कमांड का इस्तेमाल करें: आपको जिस प्रोजेक्ट को बनाना है उसका आईडी सेट करके, PROJECT_ID की जगह पर उसे डालें.gcloud projects create PROJECT_ID
पुष्टि करने और अनुमति देने की सुविधा सेट अप करना
Google Chat ऐप्लिकेशन के लिए, आपको OAuth की सहमति वाली स्क्रीन कॉन्फ़िगर करनी होगी, ताकि उपयोगकर्ता Google Workspace के ऐप्लिकेशन में आपके ऐप्लिकेशन को अनुमति दे सकें. इनमें Google Chat भी शामिल है.
इस ट्यूटोरियल में, हमने एक ऐसा Chat ऐप्लिकेशन डिप्लॉय किया है जो सिर्फ़ जांच और इंटरनल इस्तेमाल के लिए है. इसलिए, सहमति वाली स्क्रीन के लिए प्लेसहोल्डर की जानकारी का इस्तेमाल किया जा सकता है. Chat ऐप्लिकेशन को पब्लिश करने से पहले, प्लेसहोल्डर की जानकारी को असल जानकारी से बदलें.
Google Cloud console में, मेन्यू > > ब्रैंडिंग पर जाएं.
अगर आपने पहले से हीको कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, ऑडियंस, और डेटा ऐक्सेस में जाकर, OAuth की सहमति स्क्रीन की ये सेटिंग कॉन्फ़िगर की जा सकती हैं. अगर आपको कोई मैसेज दिखता है, जिसमें लिखा है कि अभी तक कॉन्फ़िगर नहीं किया गया है, तो शुरू करें पर क्लिक करें:
- ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में
Contact Manager
टाइप करें. - उपयोगकर्ता सहायता ईमेल में, अपना ईमेल पता या कोई सही Google ग्रुप चुनें.
- आगे बढ़ें पर क्लिक करें.
- ऑडियंस सेक्शन में जाकर, इंटरनल चुनें. अगर आपको इंटरनल चुनने में समस्या आ रही है, तो एक्सटर्नल चुनें.
- आगे बढ़ें पर क्लिक करें.
- संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव के बारे में सूचना मिल सके.
- आगे बढ़ें पर क्लिक करें.
- पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति को पढ़ें. अगर आप इस नीति से सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति से सहमत हूं को चुनें.
- जारी रखें पर क्लिक करें.
- बनाएं पर क्लिक करें.
- अगर आपने उपयोगकर्ता टाइप के लिए बाहरी चुना है, तो टेस्ट उपयोगकर्ता जोड़ें:
- ऑडियंस पर क्लिक करें.
- टेस्ट उपयोगकर्ता में जाकर, उपयोगकर्ता जोड़ें पर क्लिक करें.
- अपना ईमेल पता और टेस्ट के लिए अनुमति पा चुके अन्य उपयोगकर्ताओं के ईमेल पते डालें. इसके बाद, सेव करें पर क्लिक करें.
- ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में
Chat ऐप्लिकेशन बनाना और उसे डिप्लॉय करना
नीचे दिए गए सेक्शन में, आपको एक पूरा Apps Script प्रोजेक्ट कॉपी करना होगा और उसे अपडेट करना होगा. इस प्रोजेक्ट में, आपके Chat ऐप्लिकेशन के लिए ज़रूरी सभी ऐप्लिकेशन कोड मौजूद होते हैं. इसलिए, हर फ़ाइल को कॉपी करके चिपकाने की ज़रूरत नहीं है.
इसके अलावा, GitHub पर पूरा प्रोजेक्ट देखा जा सकता है.
यहां हर फ़ाइल के बारे में खास जानकारी दी गई है:
main.gs
यह ऐप्लिकेशन के सभी लॉजिक को मैनेज करता है. इनमें, इंटरैक्शन इवेंट भी शामिल हैं. जैसे, जब उपयोगकर्ता Chat ऐप्लिकेशन में मैसेज भेजते हैं, Chat ऐप्लिकेशन के मैसेज में बटन पर क्लिक करते हैं या डायलॉग बॉक्स खोलते और बंद करते हैं.
main.gs
कोड देखनाcontactForm.gs
इसमें ऐसे विजेट होते हैं जो उपयोगकर्ताओं से फ़ॉर्म डेटा पाते हैं. फ़ॉर्म इनपुट के ये विजेट, मैसेज और डायलॉग में दिखने वाले कार्ड में दिखाए जाते हैं.
contactForm.gs
कोड देखनाappsscript.json
Apps Script मेनिफ़ेस्ट, जो Chat ऐप्लिकेशन के लिए Apps Script प्रोजेक्ट को तय और कॉन्फ़िगर करता है.
appsscript.json
कोड देखना
अपने Cloud प्रोजेक्ट का नंबर और आईडी ढूंढना
Google Cloud Console में, अपने Cloud प्रोजेक्ट पर जाएं.
सेटिंग और सुविधाएं > प्रोजेक्ट सेटिंग पर क्लिक करें.
प्रोजेक्ट नंबर और प्रोजेक्ट आईडी फ़ील्ड में मौजूद वैल्यू नोट कर लें. इनका इस्तेमाल, नीचे दिए गए सेक्शन में किया जा सकता है.
Apps Script प्रोजेक्ट बनाना
Apps Script प्रोजेक्ट बनाने और उसे अपने Cloud प्रोजेक्ट से कनेक्ट करने के लिए:
- Google Chat में संपर्क मैनेज करें Apps Script प्रोजेक्ट खोलने के लिए, नीचे दिए गए बटन पर क्लिक करें.
प्रोजेक्ट खोलना - खास जानकारी पर क्लिक करें.
- खास जानकारी वाले पेज पर,
कॉपी बनाएं पर क्लिक करें.
Apps Script प्रोजेक्ट की कॉपी का नाम डालें:
Google Chat में संपर्कों को मैनेज करने की सुविधा की कॉपी पर क्लिक करें.
प्रोजेक्ट का टाइटल में,
Contact Manager - Google Chat app
टाइप करेंनाम बदलें पर क्लिक करें.
Apps Script प्रोजेक्ट का Cloud प्रोजेक्ट सेट करना
- अपने Apps Script प्रोजेक्ट में,
प्रोजेक्ट सेटिंग पर क्लिक करें.
- Google Cloud Platform (GCP) प्रोजेक्ट में जाकर, प्रोजेक्ट बदलें पर क्लिक करें.
- GCP प्रोजेक्ट नंबर में, अपने Cloud प्रोजेक्ट का प्रोजेक्ट नंबर चिपकाएं.
- प्रोजेक्ट सेट करें पर क्लिक करें. Cloud प्रोजेक्ट और Apps Script प्रोजेक्ट अब कनेक्ट हो गए हैं.
Apps Script का डिप्लॉयमेंट बनाना
अब जब पूरा कोड मौजूद है, तो Apps Script प्रोजेक्ट को डिप्लॉय करें. Google Cloud में Chat ऐप्लिकेशन को कॉन्फ़िगर करते समय, डिप्लॉयमेंट आईडी का इस्तेमाल किया जाता है.
Apps Script में, Chat ऐप्लिकेशन का प्रोजेक्ट खोलें.
डिप्लॉय करें > नया डिप्लॉयमेंट पर क्लिक करें.
अगर ऐड-ऑन पहले से चुना नहीं गया है, तो डिप्लॉयमेंट टाइप
के बगल में, टाइप चुनें पर क्लिक करें और ऐड-ऑन चुनें.
जानकारी में, इस वर्शन के बारे में जानकारी डालें, जैसे कि
Test of Contact Manager
.डिप्लॉय करें पर क्लिक करें. Apps Script, डिप्लॉयमेंट के पूरा होने की जानकारी देता है और डिप्लॉयमेंट आईडी उपलब्ध कराता है.
डिप्लॉयमेंट आईडी कॉपी करने के लिए,
कॉपी करें पर क्लिक करें. इसके बाद, हो गया पर क्लिक करें.
Google Cloud Console में Chat ऐप्लिकेशन को कॉन्फ़िगर करना
इस सेक्शन में, Google Cloud कंसोल में Google Chat API को कॉन्फ़िगर करने का तरीका बताया गया है. इसमें आपके Chat ऐप्लिकेशन की जानकारी शामिल है. साथ ही, उस डिप्लॉयमेंट का आईडी भी शामिल है जिसे आपने अभी-अभी अपने Apps Script प्रोजेक्ट से बनाया है.
Google Cloud console में, मेन्यू > ज़्यादा प्रॉडक्ट > Google Workspace > प्रॉडक्ट लाइब्रेरी > Google Chat API > मैनेज करें > कॉन्फ़िगरेशन पर क्लिक करें.
ऐप्लिकेशन का नाम में,
Contact Manager
टाइप करें.अवतार यूआरएल में,
https://developers.google.com/chat/images/contact-icon.png
टाइप करें.जानकारी में,
Manage your personal and business contacts
टाइप करें.इंटरैक्टिव सुविधाएं चालू करें टॉगल को चालू करने के लिए क्लिक करें.
फ़ंक्शन में जाकर, 1:1 मैसेज पाएं और स्पेसेज़ और ग्रुप बातचीत में शामिल हों चेकबॉक्स चुनें.
कनेक्शन सेटिंग में जाकर, Apps Script चुनें.
डिप्लॉयमेंट आईडी में, वह Apps Script डिप्लॉयमेंट आईडी चिपकाएं जिसे आपने Apps Script डिप्लॉयमेंट बनाते समय, पिछले सेक्शन में कॉपी किया था.
स्लैश कमांड में जाकर, स्लैश कमांड
/about
और/addContact
सेट अप करें:- पहला स्लैश कमांड सेट अप करने के लिए, स्लैश कमांड जोड़ें पर क्लिक करें.
- नाम में,
/about
टाइप करें. - कमांड आईडी में,
1
टाइप करें. - जानकारी में,
Learn how to use this Chat app to manage your contacts
टाइप करें. - डायलॉग बॉक्स खोलता है को चुनें.
- हो गया पर क्लिक करें.
- कोई दूसरा स्लैश कमांड सेट अप करने के लिए, स्लैश कमांड जोड़ें पर क्लिक करें.
- नाम में,
/addContact
टाइप करें - कमांड आईडी में,
2
टाइप करें. - जानकारी में,
Submit information about a contact
टाइप करें. - डायलॉग बॉक्स खोलता है को चुनें.
- हो गया पर क्लिक करें.
देखने की अनुमति में जाकर, YOUR DOMAIN में मौजूद चुनिंदा लोगों और ग्रुप के लिए, इस Chat ऐप्लिकेशन को उपलब्ध कराएं चेकबॉक्स को चुनें और अपना ईमेल पता डालें.
लॉग में जाकर, लॉगिंग में गड़बड़ियां लॉग करें को चुनें.
सेव करें पर क्लिक करें. 'कॉन्फ़िगरेशन सेव हो गया' मैसेज दिखेगा.
Chat ऐप्लिकेशन, Chat में इंस्टॉल और टेस्ट करने के लिए तैयार है.
Chat ऐप्लिकेशन की जांच करना
Chat ऐप्लिकेशन की जांच करने के लिए, Chat ऐप्लिकेशन में डायरेक्ट मैसेज स्पेस खोलें और कोई मैसेज भेजें:
उस Google Workspace खाते का इस्तेमाल करके Google Chat खोलें जिसका इस्तेमाल आपने, खुद को भरोसेमंद टेस्टर के तौर पर जोड़ते समय किया था.
- नई चैट पर क्लिक करें.
- एक या उससे ज़्यादा लोगों को जोड़ें फ़ील्ड में, अपने Chat ऐप्लिकेशन का नाम लिखें.
नतीजों में से अपना चैट ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलता है.
Chat ऐप्लिकेशन में, नए डायरेक्ट मैसेज में
/addContact
टाइप करें और Enter दबाएं.इसके बाद खुलने वाले डायलॉग बॉक्स में, संपर्क जानकारी डालें:
- नाम और सरनेम टेक्स्ट फ़ील्ड में, कोई नाम डालें.
- जन्म की तारीख वाले तारीख चुनने वाले टूल में, कोई तारीख चुनें.
- संपर्क का टाइप में जाकर, ऑफ़िस या निजी रेडियो बटन चुनें.
समीक्षा करें और सबमिट करें पर क्लिक करें.
पुष्टि करने वाले डायलॉग बॉक्स में, सबमिट की गई जानकारी की समीक्षा करें और सबमिट करें पर क्लिक करें. Chat ऐप्लिकेशन, टेक्स्ट मैसेज के साथ जवाब देता है, जिसमें
✅ CONTACT NAME has been added to your contacts.
लिखा होता है.इसके अलावा, यहां दिए गए तरीकों से भी संपर्क फ़ॉर्म को टेस्ट किया जा सकता है और सबमिट किया जा सकता है:
/about
स्लैश कमांड का इस्तेमाल करें. चैट ऐप्लिकेशन, टेक्स्ट मैसेज औरAdd a contact
लिखे हुए ऐक्सेसरी विजेट बटन के साथ जवाब देता है. संपर्क फ़ॉर्म वाला डायलॉग खोलने के लिए, बटन पर क्लिक करें.- Chat ऐप्लिकेशन को
Hello
जैसे स्लैश कमांड के बिना डायरेक्ट मैसेज भेजना. Chat ऐप्लिकेशन, टेक्स्ट और कार्ड के साथ जवाब देता है. कार्ड में संपर्क फ़ॉर्म होता है.
व्यवस्थित करें
हमारा सुझाव है कि आप इस ट्यूटोरियल में इस्तेमाल किए गए संसाधनों के लिए, अपने Google Cloud खाते से शुल्क लगने से बचने के लिए, Cloud प्रोजेक्ट मिटा दें.
- Google Cloud Console में, संसाधन मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.
- प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
- डायलॉग में, प्रोजेक्ट आईडी टाइप करें. इसके बाद, प्रोजेक्ट को मिटाने के लिए बंद करें पर क्लिक करें.
मिलते-जुलते विषय
- स्लैश कमांड का जवाब देना
- Google Chat के उपयोगकर्ताओं की जानकारी इकट्ठा और प्रोसेस करना
- इंटरैक्टिव डायलॉग बॉक्स खोलना
- Google Chat ऐप्लिकेशन के अन्य सैंपल एक्सप्लोर करना