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

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

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

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

HTTP

Apps Script

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 चुनें और प्रोजेक्ट के लिए डिप्लॉयमेंट आईडी दें.

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

      • ADDED_TO_SPACE: जब कोई उपयोगकर्ता, Chat ऐप्लिकेशन को ग्रुप बातचीत या स्पेस में जोड़ता है या 1:1 मैसेज के लिए Chat ऐप्लिकेशन इंस्टॉल करता है.
      • MESSAGE: जब कोई उपयोगकर्ता 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 के दस्तावेज़ में Google Chat ऐप्लिकेशन के लिए इंटरैक्टिव सुविधाओं की जांच करें देखें.

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

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

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

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

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