इस ट्यूटोरियल में, Google Chat ऐप्लिकेशन बनाने का तरीका बताया गया है. इससे Google Chat के उपयोगकर्ताओं को अपने निजी और कारोबार से जुड़े संपर्कों को मैनेज करने में मदद मिलती है. जानकारी इकट्ठा करने के लिए, Chat ऐप्लिकेशन उपयोगकर्ताओं को कार्ड मैसेज और डायलॉग में संपर्क फ़ॉर्म भरने के लिए कहता है.
Chat ऐप्लिकेशन को इस्तेमाल करने का तरीका देखें:
-
दूसरी इमेज. Chat ऐप्लिकेशन, एक डायलॉग बॉक्स खोलता है. इसमें उपयोगकर्ता, किसी संपर्क की जानकारी डाल सकते हैं. -
तीसरी इमेज. Chat ऐप्लिकेशन, पुष्टि करने वाला डायलॉग बॉक्स दिखाता है, ताकि उपयोगकर्ता सबमिट करने से पहले, जानकारी की समीक्षा कर सकें और उसकी पुष्टि कर सकें. -
चौथी इमेज. उपयोगकर्ता के फ़ॉर्म सबमिट करने के बाद, Chat ऐप्लिकेशन उसे एक निजी मैसेज भेजता है. इस मैसेज से, फ़ॉर्म सबमिट होने की पुष्टि की जाती है. -
पांचवीं इमेज. Chat ऐप्लिकेशन, उपयोगकर्ताओं को मैसेज में कार्ड से संपर्क जोड़ने के लिए भी कहता है.
ज़रूरी शर्तें
- आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
मकसद
card
ऑब्जेक्ट के तौर पर, यूज़र इंटरफ़ेस (यूआई) डिज़ाइन और बनाएं और मैसेज और डायलॉग में यूआई दिखाएं.- फ़ॉर्म इनपुट विजेट का इस्तेमाल करके, उपयोगकर्ताओं की सबमिट की गई जानकारी पाना और उसे प्रोसेस करना.
- टेक्स्ट, कार्ड, और ऐक्सेसरी विजेट वाले मैसेज भेजकर, स्लैश कमांड का जवाब दें.
आर्किटेक्चर
Chat ऐप्लिकेशन, Google Apps Script में बनाया गया है. यह Chat के उपयोगकर्ताओं के मैसेज को प्रोसेस करने और उनका जवाब देने के लिए, इंटरैक्शन इवेंट का इस्तेमाल करता है.
इस इमेज में दिखाया गया है कि आम तौर पर, कोई उपयोगकर्ता Chat ऐप्लिकेशन के साथ कैसे इंटरैक्ट कर सकता है:
उपयोगकर्ता, Chat ऐप्लिकेशन से डायरेक्ट मैसेज खोलता है या किसी मौजूदा स्पेस में Chat ऐप्लिकेशन को जोड़ता है.
Chat ऐप्लिकेशन, उपयोगकर्ता को संपर्क जोड़ने के लिए कहता है. इसके लिए, वह संपर्क फ़ॉर्म बनाकर उसे
card
ऑब्जेक्ट के तौर पर दिखाता है. संपर्क फ़ॉर्म प्रज़ेंट करने के लिए, Chat ऐप्लिकेशन उपयोगकर्ताओं को इन तरीकों से जवाब देता है:- @नाम टैग करने और डायरेक्ट मैसेज का जवाब, कार्ड मैसेज के ज़रिए देता है. इसमें संपर्क फ़ॉर्म होता है.
- संपर्क फ़ॉर्म के साथ डायलॉग खोलकर, स्लैश कमांड
/addContact
का जवाब देता है. - स्लैश निर्देश
/about
का जवाब, टेक्स्ट मैसेज के ज़रिए देता है. इस मैसेज में संपर्क जोड़ें बटन होता है. इस बटन पर क्लिक करके, उपयोगकर्ता संपर्क फ़ॉर्म वाला डायलॉग बॉक्स खोल सकते हैं.
संपर्क फ़ॉर्म दिखाए जाने पर, उपयोगकर्ता इन फ़ील्ड और विजेट में संपर्क जानकारी डालता है:
- नाम और उपनाम: ऐसा
textInput
विजेट जो स्ट्रिंग स्वीकार करता है. - जन्म की तारीख: यह एक ऐसा
dateTimePicker
विजेट है जिसमें सिर्फ़ तारीखें डाली जा सकती हैं. - संपर्क का टाइप: रेडियो बटन का ऐसा
selectionInput
विजेट जिसकी मदद से उपयोगकर्ता, एक स्ट्रिंग वैल्यू (Personal
याWork
) चुनकर सबमिट कर सकते हैं. - समीक्षा करें और सबमिट करें बटन:
buttonList
button
विजेट वाला कलेक्शन, जिस पर उपयोगकर्ता अपनी डाली गई वैल्यू सबमिट करने के लिए क्लिक करता है.
- नाम और उपनाम: ऐसा
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 CLI को इंस्टॉल और शुरू करें.
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 ग्रुप चुनें.
डेवलपर की संपर्क जानकारी में जाकर, अपना ईमेल पता डालें.
सेव करें और जारी रखें पर क्लिक करें.
दायरे पेज पर, सेव करें और जारी रखें पर क्लिक करें. (Chat ऐप्लिकेशन के लिए, OAuth के किसी भी दायरे की ज़रूरत नहीं है.)
खास जानकारी देखें. इसके बाद, डैशबोर्ड पर वापस जाएं पर क्लिक करें.
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 स्क्रिप्ट डिप्लॉयमेंट आईडी चिपकाएं जिसे आपने पिछले सेक्शन में 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 ऐप्लिकेशन चुनें. एक डायरेक्ट मैसेज खुलेगा.
Chat ऐप्लिकेशन में, नए डायरेक्ट मैसेज में
/addContact
टाइप करें और Enter दबाएं.इसके बाद खुलने वाले डायलॉग बॉक्स में, संपर्क जानकारी डालें:
- नाम और सरनेम टेक्स्ट फ़ील्ड में, कोई नाम डालें.
- जन्म की तारीख के लिए तारीख चुनने वाले टूल में, कोई तारीख चुनें.
- संपर्क का टाइप में जाकर, ऑफ़िस या निजी रेडियो बटन चुनें.
समीक्षा करें और सबमिट करें पर क्लिक करें.
पुष्टि करने वाले डायलॉग बॉक्स में, सबमिट की गई जानकारी की समीक्षा करें और सबमिट करें पर क्लिक करें. Chat ऐप्लिकेशन, जवाब के तौर पर एक मैसेज भेजता है. इसमें बताया जाता है कि
✅ CONTACT NAME has been added to your contacts.
.इसके अलावा, संपर्क फ़ॉर्म को इन तरीकों से भी टेस्ट किया जा सकता है और सबमिट किया जा सकता है:
/about
स्लैश कमांड का इस्तेमाल करें. Chat ऐप्लिकेशन, जवाब के तौर पर एक मैसेज भेजता है. इसमें ऐक्सेसरी वाला विजेट बटन भी होता है, जिस परAdd a contact
लिखा होता है. संपर्क फ़ॉर्म वाला डायलॉग खोलने के लिए, बटन पर क्लिक करें.- Chat ऐप्लिकेशन पर, स्लैश कमांड के बिना डायरेक्ट मैसेज भेजें. जैसे,
Hello
. Chat ऐप्लिकेशन, टेक्स्ट और कार्ड के साथ जवाब देता है. कार्ड में संपर्क फ़ॉर्म होता है.
व्यवस्थित करें
हमारा सुझाव है कि आप इस ट्यूटोरियल में इस्तेमाल किए गए संसाधनों के लिए, अपने Google Cloud खाते से शुल्क लगने से बचने के लिए, Cloud प्रोजेक्ट मिटा दें.
- Google Cloud Console में, संसाधन मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन> संसाधन मैनेज करें पर क्लिक करें.
- प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
- डायलॉग में, प्रोजेक्ट आईडी टाइप करें. इसके बाद, प्रोजेक्ट को मिटाने के लिए बंद करें पर क्लिक करें.
मिलते-जुलते विषय
- स्लैश कमांड का जवाब देना
- Google Chat के उपयोगकर्ताओं की जानकारी इकट्ठा और प्रोसेस करना
- इंटरैक्टिव डायलॉग बॉक्स खोलना
- Google Chat के अन्य ऐप्लिकेशन के सैंपल एक्सप्लोर करना