इस ट्यूटोरियल में, Google Chat ऐप्लिकेशन बनाने का तरीका बताया गया है. इससे Google Chat के उपयोगकर्ताओं को अपने निजी और कारोबार से जुड़े संपर्कों को मैनेज करने में मदद मिलती है. इकट्ठा करने के लिए तो Chat ऐप्लिकेशन उपयोगकर्ताओं को उन सभी कामों के लिए कार्ड मैसेज और डायलॉग बॉक्स में, संपर्क करने के लिए फ़ॉर्म दिया जाता है.
Chat ऐप्लिकेशन को इस्तेमाल करने का तरीका देखें:
-
दूसरी इमेज. Chat ऐप्लिकेशन, एक डायलॉग बॉक्स खोलता है. इसमें उपयोगकर्ता, किसी संपर्क की जानकारी डाल सकते हैं. -
तीसरी इमेज. कॉन्टेंट बनाने Chat ऐप्लिकेशन, पुष्टि करने वाला डायलॉग दिखाता है. लोग इस जानकारी की समीक्षा और पुष्टि कर सकें, सबमिट करना. -
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
चौथी इमेज. उपयोगकर्ता के सबमिट करने के बाद फ़ॉर्म सबमिट करने के बाद, Chat ऐप्लिकेशन सबमिट करने की पुष्टि करने के लिए मैसेज भेजें. -
पांचवीं इमेज. कॉन्टेंट बनाने Chat ऐप्लिकेशन, उपयोगकर्ताओं को संपर्क जोड़ने के लिए भी कहता है मैसेज में कार्ड से.
ज़रूरी शर्तें
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
मकसद
- यूज़र इंटरफ़ेस (यूआई) डिज़ाइन करना और बनाना
card
ऑब्जेक्ट के तौर पर शामिल किया जा सकता है और मैसेज और डायलॉग में यूज़र इंटरफ़ेस (यूआई) दिखाया जा सकता है. - उपयोगकर्ता की ओर से सबमिट की गई जानकारी को पाने और प्रोसेस करने का तरीका फ़ॉर्म इनपुट विजेट जोड़ें.
- स्लैश निर्देशों का जवाब दें. इसके लिए, टेक्स्ट, कार्ड, और ऐक्सेसरी विजेट वाले मैसेज भेजें.
आर्किटेक्चर
Chat ऐप्लिकेशन, Google Apps Script में बनाया गया है. यह Chat के उपयोगकर्ताओं के मैसेज को प्रोसेस करने और उनका जवाब देने के लिए, इंटरैक्शन इवेंट का इस्तेमाल करता है.
यहां दिए गए चार्ट से पता चलता है कि उपयोगकर्ता आम तौर पर चैट ऐप्लिकेशन:
कोई उपयोगकर्ता, Chat ऐप्लिकेशन से डायरेक्ट मैसेज खोलता है या Chat ऐप्लिकेशन को किसी मौजूदा स्पेस में जोड़ता है.
Chat ऐप्लिकेशन, उपयोगकर्ता को संपर्क जोड़ने के लिए कहता है. इसके लिए, वह संपर्क फ़ॉर्म बनाकर उसे
card
ऑब्जेक्ट के तौर पर दिखाता है. संपर्क फ़ॉर्म दिखाने के लिए, Chat ऐप्लिकेशन उपयोगकर्ताओं को इन तरीकों से जवाब देता है:- @नाम से मैसेज और डायरेक्ट मैसेज का जवाब देने के लिए, संपर्क फ़ॉर्म शामिल होता है.
- यह डायलॉग बॉक्स खोलकर, स्लैश निर्देश
/addContact
का जवाब देता है: संपर्क फ़ॉर्म भरें. - यह स्लैश कमांड
/about
का जवाब ऐसे मैसेज के साथ देता है जिसमें कोई संपर्क जोड़ें बटन. इस बटन पर क्लिक करके, लोग संपर्क फ़ॉर्म भरें.
संपर्क फ़ॉर्म दिए जाने पर, उपयोगकर्ता अपनी संपर्क जानकारी डालता है को अपडेट करें:
- नाम और सरनेम: स्ट्रिंग स्वीकार करने वाला ऐसा
textInput
विजेट. - जन्म की तारीख: यह एक ऐसा
dateTimePicker
विजेट है जिसमें सिर्फ़ तारीखें डाली जा सकती हैं. - संपर्क का टाइप: a
selectionInput
रेडियो बटन का विजेट, जो उपयोगकर्ताओं को कोई स्ट्रिंग चुनने और सबमिट करने की सुविधा देता है मान (Personal
याWork
). - समीक्षा करें और सबमिट करें बटन: a
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 सीएलआई.
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 ग्रुप.
डेवलपर की संपर्क जानकारी में जाकर, अपना ईमेल पता डालें.
सेव करें और जारी रखें पर क्लिक करें.
दायरे पेज पर, सेव करें और जारी रखें पर क्लिक करें. ( चैट ऐप्लिकेशन के लिए, OAuth के किसी भी दायरे की ज़रूरत नहीं होती.
खास जानकारी देखें. इसके बाद, डैशबोर्ड पर वापस जाएं पर क्लिक करें.
Chat ऐप्लिकेशन बनाना और डिप्लॉय करना
नीचे दिए गए सेक्शन में, आपने उस पूरे डेटा को कॉपी करके अपडेट किया Apps Script प्रोजेक्ट, जिसमें सभी ज़रूरी ऐप्लिकेशन शामिल हैं आपको चैट ऐप्लिकेशन का कोड मिलेगा, इसलिए आपको कोड को कॉपी करने की ज़रूरत नहीं है और हर फ़ाइल को चिपकाएं.
इसके अलावा, GitHub पर पूरा प्रोजेक्ट देखा जा सकता है.
यहां हर फ़ाइल की खास जानकारी दी गई है:
main.gs
यह ऐप्लिकेशन के सभी लॉजिक को मैनेज करता है. इसमें, उपयोगकर्ताओं के मैसेज भेजने के दौरान होने वाले इंटरैक्शन इवेंट भी शामिल हैं को खोजने के लिए, Chat ऐप्लिकेशन के बटन पर क्लिक करें. या चैट ऐप्लिकेशन के मैसेज खोलें या डायलॉग बॉक्स बंद करें.
main.gs
कोड देखनाcontactForm.gs
इसमें ऐसे विजेट शामिल होते हैं जिन्हें उपयोगकर्ताओं से फ़ॉर्म डेटा मिलता है. ये फ़ॉर्म इनपुट विजेट, मैसेज और डायलॉग बॉक्स में दिखने वाले कार्ड में दिखते हैं.
contactForm.gs
कोड देखेंappsscript.json
कॉन्टेंट बनाने Apps Script मेनिफ़ेस्ट जो चैट ऐप्लिकेशन.
appsscript.json
कोड देखना
अपने Cloud प्रोजेक्ट का नंबर और आईडी ढूंढना
Google Cloud Console में, अपने Cloud प्रोजेक्ट पर जाएं.
सेटिंग और उपयोगिता पर क्लिक करें > प्रोजेक्ट सेटिंग पर क्लिक करें.
प्रोजेक्ट नंबर और प्रोजेक्ट आईडी फ़ील्ड में मौजूद वैल्यू नोट कर लें. आपने लोगों तक पहुंचाया मुफ़्त में नीचे दिए गए सेक्शन में उनका इस्तेमाल करें.
Apps Script प्रोजेक्ट बनाना
Apps Script प्रोजेक्ट बनाने और उसे अपने Cloud प्रोजेक्ट:
- Google Chat में संपर्कों को मैनेज करें स्क्रिप्ट प्रोजेक्ट खोलने के लिए, नीचे दिए गए बटन पर क्लिक करें.
प्रोजेक्ट खोलें - खास जानकारी पर क्लिक करें.
- खास जानकारी देने वाले पेज पर, कॉपी बनाएं पर क्लिक करें.
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
लिखें. - Description में, टाइप करें
Learn how to use this Chat app to manage your contacts
. - इस बटन पर क्लिक करने से एक डायलॉग बॉक्स खुलता है को चुनें.
- हो गया पर क्लिक करें.
- कोई दूसरा स्लैश कमांड सेट अप करने के लिए, स्लैश कमांड जोड़ें पर क्लिक करें.
- नाम में,
/addContact
टाइप करें - कमांड आईडी में,
2
लिखें. - Description में, टाइप करें
Submit information about a contact
. - इस बटन पर क्लिक करने से एक डायलॉग बॉक्स खुलता है को चुनें.
- हो गया पर क्लिक करें.
प्रॉडक्ट की उपलब्धता में जाकर, YOUR DOMAIN में मौजूद चुनिंदा लोगों और ग्रुप के लिए, इस 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 ऐप्लिकेशन के अन्य सैंपल एक्सप्लोर करना