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

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

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

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

HTTP

Apps Script

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

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

  • स्पेस में जोड़ने या मैसेज भेजने के लिए, Chat ऐप्लिकेशन का नाम टैग करें.
  • 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. ज़रूरी नहीं: एक से ज़्यादा एंडपॉइंट या फ़ंक्शन पर इवेंट ऑब्जेक्ट पाने के लिए, कनेक्शन सेटिंग > ट्रिगर पर जाएं. इसके बाद, यहां दिए गए चैट ट्रिगर के लिए कॉलबैक फ़ंक्शन उपलब्ध कराएं या उन्हें अपडेट करें:

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

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

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

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

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

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

Google Workspace के मौजूदा ऐड-ऑन इस्तेमाल करने से पहले ध्यान देने वाली बातें

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

  • लोगों और Google Workspace एडमिन, दोनों के पास मार्केटप्लेस से आपका ऐड-ऑन इंस्टॉल करने की सुविधा होनी चाहिए. इंस्टॉल करने की इन सेटिंग को Google Workspace Marketplace SDK टूल में कॉन्फ़िगर किया जा सकता है.
  • चैट ऐप्लिकेशन, मेनिफ़ेस्ट के 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 के अन्य ऐप्लिकेशन के लिए किया जाता है.