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

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

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

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

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

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

ट्रिगर

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अगर आपको इंटरैक्शन इवेंट का जवाब 30 सेकंड के बाद देना है, तो आपको 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 के बारे में खास जानकारी