Google Chat का इंटरफ़ेस बनाएं

इस पेज पर, Google Workspace के ऐड-ऑन के लिए यूज़र इंटरफ़ेस (यूआई) बनाने के तरीके की खास जानकारी दी गई है. इन ऐड-ऑन की मदद से, Google Chat की सुविधाओं को बढ़ाया जा सकता है.

Chat ऐप्लिकेशन के लिए इंटरफ़ेस बनाने के लिए, ऐड-ऑन के इन कॉम्पोनेंट का इस्तेमाल करें:

• ट्रिगर: ये वे तरीके हैं जिनसे Google Chat के उपयोगकर्ता, Chat ऐप्लिकेशन को चालू कर सकते हैं. जैसे, किसी स्पेस में Chat ऐप्लिकेशन जोड़ना या उसे मैसेज भेजना.
• इवेंट ऑब्जेक्ट: यह वह डेटा है जो Chat ऐप्लिकेशन को ट्रिगर या यूज़र इंटरफ़ेस (यूआई) के साथ होने वाले इंटरैक्शन से मिलता है.
• कार्रवाइयां: ये वे तरीके हैं जिनसे Chat ऐप्लिकेशन, इंटरैक्शन का जवाब दे सकते हैं. जैसे, मैसेज भेजना या कार्ड पर आधारित यूज़र इंटरफ़ेस (यूआई) दिखाना.

Chat ऐप्लिकेशन, इन इंटरफ़ेस में कार्ड बना सकते हैं और उन्हें दिखा सकते हैं:

• मैसेज में टेक्स्ट, स्टैटिक या इंटरैक्टिव कार्ड, और बटन शामिल हो सकते हैं.
• डायलॉग, कार्ड होते हैं. ये नई विंडो में खुलते हैं और आम तौर पर, उपयोगकर्ताओं से जानकारी सबमिट करने के लिए कहते हैं.
• लिंक की झलक, कार्ड होते हैं. ये किसी बाहरी सेवा के बारे में जानकारी की झलक दिखाते हैं.

ट्रिगर

इस सेक्शन में, उन ट्रिगर के बारे में बताया गया है जिनका इस्तेमाल Google Workspace के ऐड-ऑन, Chat में करते हैं.

ट्रिगर, वे खास तरीके हैं जिनसे उपयोगकर्ता, Chat यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके Chat ऐप्लिकेशन को चालू करते हैं. जैसे, @mention का इस्तेमाल करना या ऐप्लिकेशन के कमांड का इस्तेमाल करना.

यहां दी गई टेबल में, Chat के ट्रिगर, उनके बारे में जानकारी, और Chat ऐप्लिकेशन आम तौर पर कैसे जवाब देते हैं, यह बताया गया है:

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

किसी ट्रिगर का जवाब देने के लिए, ये गाइड देखें:

• Google Chat में मैसेज भेजना
• इंटरैक्टिव डायलॉग खोलना
• Google Chat के मैसेज में लिंक की झलक देखना

इवेंट ऑब्जेक्ट

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

इवेंट ऑब्जेक्ट को मैनेज करने के बारे में जानने के लिए, ये गाइड देखें:

• Google Chat में मैसेज भेजना
• इंटरैक्टिव डायलॉग खोलना
• Google Chat के मैसेज में लिंक की झलक देखना

Chat और Google Workspace के अन्य ऐप्लिकेशन में, ऐड-ऑन के इवेंट ऑब्जेक्ट के बारे में जानने के लिए, इवेंट ऑब्जेक्ट लेख पढ़ें.

चैट से जुड़ी कार्रवाइयां

इस सेक्शन में, यह बताया गया है कि Chat ऐप्लिकेशन, उपयोगकर्ता के इंटरैक्शन का जवाब देने के लिए, ऐड-ऑन की कार्रवाइयों का इस्तेमाल कैसे कर सकते हैं.

ऐड-ऑन की कार्रवाई से जवाब देने के लिए, Chat ऐप्लिकेशन को 30 सेकंड के अंदर जवाब देना होगा. साथ ही, जवाब को उस स्पेस में पोस्ट करना होगा जहां इंटरैक्शन हुआ था. इसके अलावा, Chat ऐप्लिकेशन को पुष्टि करने की सुविधा सेट अप करनी होगी और जवाब देने के लिए Google Chat API को कॉल करना होगा.

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

उपयोगकर्ता के इंटरैक्शन का जवाब देने के लिए, Chat ऐप्लिकेशन को संबंधित इवेंट ऑब्जेक्ट को मैनेज करना होगा और JSON के इन ऑब्जेक्ट में से कोई एक ऑब्जेक्ट दिखाना होगा:

• DataActions: Google Workspace का डेटा बनाता है या अपडेट करता है. Chat के मैसेज भेजने या अपडेट करने के लिए, ऑब्जेक्ट में वह मार्कअप होना चाहिए जो डेटा में किए गए बदलावों को तय करता है. इसे chatDataActionMarkup के तौर पर दिखाया जाता है.Message
• RenderActions: डायलॉग बनाता है या अपडेट करता है . इसके अलावा, मल्टी-सेलेक्ट मेन्यू के लिए इनपुट के सुझाव देता है .
• AuthorizationError: उपयोगकर्ताओं को अनुमति देने वाले कार्ड के साथ, Google से बाहर की किसी सेवा में साइन इन करने या पुष्टि करने के लिए कहता है. Chat में, अनुमति देने वाले सिर्फ़ बुनियादी कार्ड की सुविधा उपलब्ध है.

यहां दी गई टेबल में, यह बताया गया है कि Chat ऐप्लिकेशन, कार्रवाइयों से कैसे जवाब दे सकते हैं. Chat ऐप्लिकेशन, JSON ऑब्जेक्ट दिखा सकते हैं या Apps Script के जवाब को AddOnResponseServiceबना सकते हैं.

Google Chat API का इस्तेमाल करके जवाब देना

ऐड-ऑन की कार्रवाई दिखाने के बजाय, Chat ऐप्लिकेशन को किसी इंटरैक्शन का जवाब देने के लिए, Google Chat API का इस्तेमाल करना पड़ सकता है. उदाहरण के लिए, Chat ऐप्लिकेशन को इनमें से कोई भी काम करने के लिए, Google Chat API को कॉल करना होगा:

• 30 सेकंड के बाद किसी इंटरैक्शन का जवाब देना.
• उस स्पेस से बाहर टास्क करना जहां इंटरैक्शन हुआ था.
• Chat में ऐसे टास्क करना जो ऐड-ऑन की कार्रवाइयों के तौर पर उपलब्ध नहीं हैं. उदाहरण के लिए, उन स्पेस की सूची बनाना जिनमें कोई उपयोगकर्ता या Chat ऐप्लिकेशन सदस्य है या किसी स्पेस में उपयोगकर्ताओं को जोड़ना.
• Chat के उपयोगकर्ता की ओर से टास्क करना. इसके लिए, उपयोगकर्ता की पुष्टि करना ज़रूरी है.

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

async function onEvent(req, res) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return res.send({});
};

def on_event(event) -> dict:
  # Trigger asynchronous job that will respond using the Google Chat API.
  ...

  # Respond with an empty response to the Google Chat platform.
  return {}

public String onEvent(JsonNode event) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return "{}";
}

function onEvent(event) {
  // Trigger asynchronous job that will respond using the Google Chat API.
  ...

  // Respond with an empty response to the Google Chat platform.
  return null;
}

Chat API की पुष्टि करने और उसे कॉल करने के बारे में जानने के लिए, Chat API की खास जानकारी देखें.

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

• Google Workspace के ऐड-ऑन के लिए ट्रिगर
• Google Chat ऐप्लिकेशन कॉन्फ़िगर करना
• इवेंट ऑब्जेक्ट
• ऐड-ऑन की कार्रवाइयां
• Google Chat में मैसेज भेजना
• इंटरैक्टिव डायलॉग खोलना
• Google Chat के मैसेज में लिंक की झलक देखना
• Chat API की खास जानकारी