इस पेज पर, Google Chat ऐप्लिकेशन के लिए तेज़ निर्देश सेट अप करने और उनका जवाब देने का तरीका बताया गया है.
क्विक कमांड की मदद से, उपयोगकर्ता किसी Chat ऐप्लिकेशन को तुरंत इस्तेमाल कर सकते हैं और उससे इंटरैक्ट कर सकते हैं. क्विक कमांड का इस्तेमाल करने के लिए, Chat स्पेस या बातचीत में Google Workspace टूल पर क्लिक करके, इंटिग्रेशन मेन्यू खोलें. इसके बाद, किसी ऐसे ऐप्लिकेशन कमांड को चुनें जिसका नाम स्लैश (/) से शुरू न होता हो. क्विक कमांड चुनने पर, उपयोगकर्ता के किसी और इनपुट के बिना, Chat ऐप्लिकेशन तुरंत चालू हो जाता है. इससे उपयोगकर्ता, ऐप्लिकेशन के साथ तेज़ी से इंटरैक्ट कर पाते हैं.
उपयोगकर्ता, स्लैश कमांड की मदद से भी चैट ऐप्लिकेशन को खोल सकते हैं. स्लैश कमांड की तुलना में, क्विक कमांड को Chat के यूज़र इंटरफ़ेस में, उपयोगकर्ता के हिसाब से नाम के साथ फ़ॉर्मैट किया जाता है. इन्हें चुनने के बाद तुरंत लागू किया जाता है. साथ ही, उपयोगकर्ता को स्लैश कमांड का नाम याद रखने या टाइप करने की ज़रूरत नहीं होती.
Google Chat API में क्विक कमांड सेट अप करना
कोई क्विक कमांड बनाने या किसी मौजूदा स्लैश कमांड को क्विक कमांड में अपडेट करने के लिए, आपको Google Chat API के लिए अपने Chat ऐप्लिकेशन के कॉन्फ़िगरेशन में कमांड के बारे में जानकारी देनी होगी.
Google Chat API में क्विक कमांड कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:
Google Cloud कंसोल में, मेन्यू > एपीआई और सेवाएं > चालू किए गए एपीआई और सेवाएं > Google Chat API पर क्लिक करें
कॉन्फ़िगरेशन पर क्लिक करें.
बेहतर सेटिंग में जाकर, ट्रिगर पर जाएं और देखें कि ऐप्लिकेशन कमांड फ़ील्ड में कोई ट्रिगर मौजूद है या नहीं. जैसे, एचटीटीपी एंडपॉइंट या Apps Script फ़ंक्शन. क्विक कमांड का जवाब देने के लिए, आपको अगले सेक्शन में इस ट्रिगर का इस्तेमाल करना होगा.
कमांड में जाकर, कोई कमांड जोड़ें पर क्लिक करें.
निर्देश के लिए निर्देश आईडी, नाम, ब्यौरा, और निर्देश का टाइप डालें:
- कमांड आईडी: यह 1 से 1,000 के बीच का एक नंबर होता है. इसका इस्तेमाल, आपका Chat ऐप्लिकेशन, कमांड को पहचानने और जवाब देने के लिए करता है.
- नाम: कमांड का डिसप्ले नेम. नाम में ज़्यादा से ज़्यादा 50 वर्ण हो सकते हैं. साथ ही, इसमें खास वर्ण भी शामिल किए जा सकते हैं.
- उपयोगकर्ता को निर्देशों को साफ़ तौर पर समझाने के लिए, छोटे, जानकारी देने वाले, और काम के शब्दों या वाक्यांशों का इस्तेमाल करें. उदाहरण के लिए, किसी संपर्क रिकॉर्ड में बदलाव करने वाले निर्देश के लिए, संपर्क अपडेट करें का इस्तेमाल करें.
- ब्यौरा: यह टेक्स्ट बताता है कि कमांड क्या करता है.
ब्यौरे में ज़्यादा से ज़्यादा 50 वर्ण हो सकते हैं. साथ ही, इसमें खास वर्ण भी शामिल किए जा सकते हैं.
- जानकारी को कम और साफ़ शब्दों में रखें, ताकि उपयोगकर्ताओं को यह पता रहे कि कमांड का इस्तेमाल करने पर उन्हें क्या मिलेगा.
- उपयोगकर्ताओं को बताएं कि Chat ऐप्लिकेशन, स्पेस में मौजूद सभी लोगों को जवाब देता है या सिर्फ़ उस व्यक्ति को जवाब देता है जिसने निर्देश दिया है. उदाहरण के लिए, क्विक कमांड इसके बारे में जानकारी के लिए, इसे इस ऐप्लिकेशन के बारे में जानें (सिर्फ़ आपको दिखेगा) के तौर पर दिखाया जा सकता है.
- निर्देश का टाइप: क्विक निर्देश चुनें.
ज़रूरी नहीं: अगर आपको चैट ऐप्लिकेशन से डायलॉग के ज़रिए निर्देश का जवाब पाना है, तो डायलॉग बॉक्स खोलें चेकबॉक्स चुनें.
सेव करें पर क्लिक करें.
अब यह क्विक कमांड, Chat ऐप्लिकेशन के लिए कॉन्फ़िगर हो गया है.
किसी तेज़ निर्देश का जवाब देना
जब उपयोगकर्ता कोई क्विक कमांड इस्तेमाल करते हैं, तो आपके Chat ऐप्लिकेशन को एक इवेंट ऑब्जेक्ट मिलता है. इसमें क्विक कमांड के बारे में जानकारी होती है.
इवेंट ऑब्जेक्ट में एक AppCommand पेलोड होता है. इसमें, ट्रिगर किए गए निर्देश (जिसमें निर्देश आईडी भी शामिल है) के बारे में जानकारी होती है, ताकि आप सही जवाब दे सकें.
किसी तेज़ निर्देश का जवाब देने के लिए, आपको ऐप्लिकेशन निर्देश ट्रिगर लागू करना होगा, ताकि आपका Chat ऐप्लिकेशन, ऐप्लिकेशन निर्देश मेटाडेटा वाले किसी भी इवेंट ऑब्जेक्ट को मैनेज कर सके.
यहां दिए गए कोड में, चैट ऐप्लिकेशन का एक उदाहरण दिया गया है, जो सहायता निर्देश का जवाब देता है. तुरंत दिए जाने वाले कमांड का जवाब देने के लिए, Chat ऐप्लिकेशन ऐप्लिकेशन कमांड ट्रिगर से इवेंट ऑब्जेक्ट मैनेज करता है. जब किसी इवेंट ऑब्जेक्ट के पेलोड में क्विक कमांड आईडी होता है, तो Chat ऐप्लिकेशन createMessageAction ऑब्जेक्ट के साथ ऐक्शन DataActions दिखाता है:
Apps Script
// The ID of the slash command "/about".
// It's not enabled by default, set to the actual ID to enable it. You must
// use the same ID as set in the Google Chat API configuration.
const HELP_COMMAND_ID = 0;
/**
* Responds to an APP_COMMAND event in Google Chat.
*
* @param {Object} event the event object from Google Chat
*/
function onAppCommand(event) {
// Stores the Google Chat app command metadata as a variable.
const appCommandMetadata = event.chat.appCommandPayload.appCommandMetadata;
if (appCommandMetadata.appCommandType == "QUICK_COMMAND") {
// Executes the quick command logic based on its ID.
// Quick command IDs are set in the Google Chat API configuration.
switch (appCommandMetadata.appCommandId) {
case HELP_COMMAND_ID:
return { hostAppDataAction: { chatDataAction: { createMessageAction: { message: {
text: 'The Avatar app replies to Google Chat messages.'
}}}}};
}
}
}
इस कोड सैंपल का इस्तेमाल करने के लिए, HELP_COMMAND_ID की जगह उस कमांड आईडी को डालें जिसे आपने Chat API में क्विक कमांड कॉन्फ़िगर करते समय बताया था.
Chat में क्विक कमांड की जांच करने के लिए, Google Workspace टूल पर क्लिक करके इंटिग्रेशन मेन्यू खोलें. इसके बाद, क्विक कमांड चुनें.