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

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

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

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

• Business या Enterprise Google Workspace खाता, जिसमें Google Chat का ऐक्सेस हो.

• Google Cloud प्रोजेक्ट. इसे बनाने के लिए, Google Cloud प्रोजेक्ट बनाना लेख पढ़ें.

• उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth को सहमति दी जाती है.
• Google Chat API को चालू करें.

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

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

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

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

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

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

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

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

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

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

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

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

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

   1. सुविधाएं में जाकर, स्पेस और ग्रुप बातचीत में शामिल हों को चुनें, ताकि आपका Chat ऐप्लिकेशन इंस्टॉल और इस्तेमाल किया जा सके.

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

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

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

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

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

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

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

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

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

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

मौजूदा Google Workspace ऐड-ऑन के लिए ज़रूरी बातें

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

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

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

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

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

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

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