Google Chat ऐप्लिकेशन को कॉन्फ़िगर करना

इस पेज पर, Google Chat ऐप्लिकेशन को Google Workspace ऐड-ऑन के तौर पर कॉन्फ़िगर और डिप्लॉय करने का तरीका बताया गया है.

Chat की सुविधाएं बढ़ाने वाले Google Workspace ऐड-ऑन को डिप्लॉय और टेस्ट करने के लिए, आपको Google Chat API का इस्तेमाल करके Chat ऐप्लिकेशन को चालू और कॉन्फ़िगर करना होगा. Chat API की कॉन्फ़िगरेशन सेटिंग में, Chat ऐप्लिकेशन के बारे में पूरी जानकारी दी जाती है. इसमें, नाम, अवतार, डिप्लॉयमेंट, और इंटरैक्टिव सुविधाओं की जानकारी शामिल होती है.

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

HTTP

• आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
• Google Cloud प्रोजेक्ट बनाएं.
• OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
• Google Workspace के इन एपीआई को चालू करें:
  • Google Chat API
  • Google Workspace ऐड-ऑन एपीआई
    Chat ऐप्लिकेशन के डिप्लॉयमेंट बनाने और मैनेज करने के लिए, Google Workspace ऐड-ऑन एपीआई का इस्तेमाल नहीं किया जा सकता. ज़्यादा जानकारी के लिए, सीमाएं और मौजूदा समस्याएं देखें.
• एचटीटीपी एंडपॉइंट, जो आपके Chat ऐप्लिकेशन के लिए सेवा आर्किटेक्चर को होस्ट करता है.

Apps Script

• आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.
• Google Cloud प्रोजेक्ट बनाएं.
• OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करें.
• Google Chat API को चालू करें.
• स्टैंडअलोन Apps Script प्रोजेक्ट बनाएं और ऐडवांस चैट सेवा चालू करें.
• addons.chat ऑब्जेक्ट और ज़रूरी स्कोप (oauthScopes) या एचटीटीपीएस यूआरएल के प्रीफ़िक्स (urlFetchWhitelist) जोड़कर, मेनिफ़ेस्ट में Chat को कॉन्फ़िगर करें.

Chat ऐप्लिकेशन के लिए डिसप्ले नेम, अवतार, और ब्यौरा चुनना

Chat ऐप्लिकेशन का नाम, अवतार, और ब्यौरा, उपयोगकर्ताओं को Chat के यूज़र इंटरफ़ेस में दिखता है. चैट ऐप्लिकेशन के साथ इंटरैक्ट करने के लिए, उपयोगकर्ता इस जानकारी को इन तरीकों से देखते हैं या उसका इस्तेमाल करते हैं:

• Chat ऐप्लिकेशन को स्पेस में जोड़ने या उसे मैसेज भेजने के लिए, @mention का इस्तेमाल करें.
• Chat ऐप्लिकेशन को खोजें और उससे डायरेक्ट मैसेज भेजें. ऐप्लिकेशन मेन्यू में, डायरेक्ट मैसेज में Chat ऐप्लिकेशन का नाम और अवतार दिखता है.
• लिखने के लिए बने बार से, उपयोगकर्ता Chat ऐप्लिकेशन ब्राउज़ कर सकते हैं. साथ ही, वे अपना नाम, अवतार, और ब्यौरा देख सकते हैं.

चैट ऐप्लिकेशन को कॉन्फ़िगर करने से पहले, आपको यह जानकारी तैयार करनी होगी:

फ़ील्ड	ब्यौरा	फ़ॉर्मैट
ऐप्लिकेशन का नाम	Chat ऐप्लिकेशन का डिसप्ले नेम.	इसमें ज़्यादा से ज़्यादा 25 अक्षर और अंक इस्तेमाल किए जा सकते हैं
अवतार का यूआरएल	वह इमेज जो आपके Chat ऐप्लिकेशन के अवतार के तौर पर दिखती है.	स्क्वेयर ग्राफ़िक इमेज (PNG या JPEG) पर ले जाने वाला एचटीटीपीएस यूआरएल. हमारा सुझाव है कि इमेज का साइज़ 256 x 256 पिक्सल या इससे ज़्यादा हो.
ब्यौरा	Chat ऐप्लिकेशन के मकसद के बारे में कम शब्दों में जानकारी.	ज़्यादा से ज़्यादा 40 अक्षर और अंक

नीचे दिए गए सेक्शन में, Chat API की कॉन्फ़िगरेशन सेटिंग में यह जानकारी दी जाती है.

Google Cloud Console में Chat ऐप्लिकेशन को कॉन्फ़िगर करना

Chat ऐप्लिकेशन की जानकारी मिलने के बाद, अपना Cloud प्रोजेक्ट खोलें और Chat API को कॉन्फ़िगर करें:

1. Google Cloud Console में, Chat API पेज पर जाएं और कॉन्फ़िगरेशन पेज पर क्लिक करें:

   Chat API के कॉन्फ़िगरेशन पेज पर जाएं

2. ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम, अवतार का यूआरएल, और ब्यौरा फ़ील्ड भरें.

3. इंटरैक्टिव सुविधाएं में जाकर, इंटरैक्टिव सुविधाएं चालू करें पर क्लिक करें. इसके बाद, यह तरीका अपनाएं:

   1. फ़ंक्शन में जाकर, एक या उससे ज़्यादा चेकबॉक्स चुनें, ताकि आपका Chat ऐप्लिकेशन इंस्टॉल और इस्तेमाल किया जा सके:

      • 1:1 मैसेज पाना: उपयोगकर्ता, Chat ऐप्लिकेशन को इंस्टॉल करके, उसमें मैसेज भेज और पा सकते हैं. यह मैसेज, उपयोगकर्ता और Chat ऐप्लिकेशन के बीच के खास स्पेस में भेजे और पाए जाते हैं.

      • स्पेस और ग्रुप बातचीत में शामिल होना: उपयोगकर्ता, कई लोगों के साथ बातचीत करने वाले स्पेस में Chat ऐप्लिकेशन को जोड़ सकते हैं और उससे इंटरैक्ट कर सकते हैं.

   2. कनेक्शन सेटिंग में जाकर, वह आर्किटेक्चर चुनें जिसका इस्तेमाल करके आपको Chat से इवेंट ऑब्जेक्ट पाने हैं:

      • एचटीटीपी सेवा का इस्तेमाल करने के लिए, एचटीटीपी एंडपॉइंट यूआरएल चुनें और यूआरएल डालें.
      • Google Apps Script प्रोजेक्ट का इस्तेमाल करने के लिए, Apps Script चुनें और प्रोजेक्ट के लिए डिप्लॉयमेंट आईडी दें.
      चेतावनी: अगर Apps Script डिप्लॉयमेंट आईडी पहले से भरा हुआ है, तो इसका मतलब है कि Cloud प्रोजेक्ट, किसी मौजूदा Google Workspace ऐड-ऑन से जुड़ा है. अगर आपने Chat API में डिप्लॉयमेंट आईडी अपडेट किया है, तो आपके ऐड-ऑन के लिए डिप्लॉयमेंट आईडी अपडेट हो जाता है. इससे Google Workspace Marketplace में आपकी लिस्टिंग पर असर पड़ सकता है. अपने ऐड-ऑन कॉन्फ़िगरेशन की समीक्षा करने के लिए, Google Workspace Marketplace के दस्तावेज़ में Google Workspace Marketplace SDK में अपना ऐप्लिकेशन कॉन्फ़िगर करें देखें.

   3. ज़रूरी नहीं: एक से ज़्यादा एंडपॉइंट या फ़ंक्शन पर इवेंट ऑब्जेक्ट पाने के लिए, बेहतर सेटिंग > ट्रिगर पर जाएं. इसके बाद, यहां दिए गए चैट ट्रिगर के लिए कॉलबैक फ़ंक्शन दें या अपडेट करें:

      ध्यान दें: अगर Apps Script के लिए ट्रिगर अपडेट नहीं किए जाते, तो आपको इस सेक्शन में मौजूद कॉलबैक फ़ंक्शन का इस्तेमाल करना होगा. जैसे, onMessage, onAddedToSpace, और onRemovedFromSpace.
      • ADDED_TO_SPACE: जब कोई उपयोगकर्ता, Chat ऐप्लिकेशन को ग्रुप बातचीत या स्पेस में जोड़ता है या 1:1 मैसेज के लिए Chat ऐप्लिकेशन इंस्टॉल करता है.
      • मैसेज: जब कोई उपयोगकर्ता Chat ऐप्लिकेशन पर मैसेज भेजता है. उदाहरण के लिए, Chat ऐप्लिकेशन पर डायरेक्ट मैसेज भेजना या कई लोगों के साथ स्पेस में Chat ऐप्लिकेशन का @mention करना.
      • REMOVED_FROM_SPACE: जब कोई उपयोगकर्ता, Chat ऐप्लिकेशन को अनइंस्टॉल करता है या किसी स्पेस से हटाता है.

   4. ज़रूरी नहीं: स्लैश कमांड या लिंक की झलक जैसी अन्य इंटरैक्टिव सुविधाएं जोड़ें.

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

4. ज़रूरी नहीं: Google Cloud Logging का इस्तेमाल करने के लिए, लॉग में जाकर, लॉगिंग में गड़बड़ियां लॉग करें चेकबॉक्स को चुनें. ज़्यादा जानकारी के लिए, Chat API के दस्तावेज़ में Chat ऐप्लिकेशन के लिए क्वेरी गड़बड़ी के लॉग देखें.

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

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

Google Workspace के मौजूदा ऐड-ऑन के लिए ध्यान देने वाली बातें

चैट ऐप्लिकेशन को, Google Workspace के अन्य ऐप्लिकेशन को बेहतर बनाने वाले Google Workspace ऐड-ऑन की तुलना में अलग कॉन्फ़िगरेशन की ज़रूरत होती है. अगर आपका ऐड-ऑन, Google Workspace के अन्य ऐप्लिकेशन के साथ काम करता है, तो Chat ऐप्लिकेशन को कॉन्फ़िगर करने के लिए, इन ज़रूरी शर्तों को ध्यान में रखें:

• Google Workspace के एडमिन और सामान्य उपयोगकर्ता, दोनों को Marketplace से आपका ऐड-ऑन इंस्टॉल करने की अनुमति होनी चाहिए. इन इंस्टॉलेशन सेटिंग को Google Workspace Marketplace SDK में कॉन्फ़िगर किया जाता है.
• Chat ऐप्लिकेशन, उस नाम और लोगो का इस्तेमाल नहीं करते हैं जिसे manifest के addons.common ऑब्जेक्ट में, Google Workspace के अन्य ऐप्लिकेशन के लिए कॉन्फ़िगर किया जाता है.
• Google Workspace Marketplace पर पब्लिश किए गए ऐड-ऑन के लिए, Google Chat API की कॉन्फ़िगरेशन सेटिंग में किए गए किसी भी बदलाव का ड्राफ़्ट सेव नहीं किया जा सकता. Chat API के कॉन्फ़िगरेशन की सेटिंग अपडेट करने और सेव करने के बाद, अपडेट किया गया Chat ऐप्लिकेशन सभी मौजूदा उपयोगकर्ताओं के लिए उपलब्ध हो जाता है. Marketplace पर मौजूद अपनी लिस्टिंग को अपडेट करने के लिए, बदलाव सबमिट करने से पहले ड्राफ़्ट बनाएं.

• अगर आपने Apps Script का इस्तेमाल करके अपना ऐड-ऑन बनाया है, तो:

  • आपको उसी Apps Script डिप्लॉयमेंट आईडी का इस्तेमाल करना होगा जिसका इस्तेमाल आपने अपने बाकी सभी ऐड-ऑन कॉन्फ़िगरेशन के लिए किया है.
  • Chat में टेस्ट डिप्लॉयमेंट इंस्टॉल करने के लिए, Apps Script एडिटर का इस्तेमाल नहीं किया जा सकता. इसके बजाय, आपको उन्हें सीधे Chat के यूज़र इंटरफ़ेस (यूआई) से इंस्टॉल करना होगा.

• अगर आपने एड-ऑन को किसी एचटीटीपी सेवा का इस्तेमाल करके बनाया है, तो Google Workspace Add-ons API का इस्तेमाल करके बनाए गए मेनिफ़ेस्ट और डिप्लॉयमेंट में, Chat ऐप्लिकेशन के कॉन्फ़िगरेशन की जानकारी शामिल न करें. Google Workspace Marketplace SDK में बताए गए एचटीटीपी डिप्लॉयमेंट का इस्तेमाल, सिर्फ़ Google Workspace के अन्य ऐप्लिकेशन के लिए किया जाता है.

मिलते-जुलते विषय

• Chat API का ऐक्सेस मैनेज करने के लिए, Google Chat API के दस्तावेज़ में Google Chat API को कॉन्फ़िगर करना देखें.
• Google Chat ऐप्लिकेशन के लिए इंटरैक्टिव सुविधाओं की जांच करना
• Google Chat में ऐप्लिकेशन पब्लिश करना