इस पेज पर, Google Chat ऐप्लिकेशन को ऐसी सेवा या टूल से कनेक्ट करने का तरीका बताया गया है जो Google Chat में शामिल नहीं है. Chat ऐप्लिकेशन अपने-आप में बेहतर होते हैं, लेकिन वे अक्सर दूसरे सिस्टम के साथ मिलकर काम करते हैं. साथ ही, उन्हें खातों को जोड़ने, डेटा ऐक्सेस करने की अनुमति देने, अतिरिक्त डेटा दिखाने या उपयोगकर्ता की प्राथमिकताओं को कॉन्फ़िगर करने के लिए, सहयोगी ऐप्लिकेशन की ज़रूरत होती है.
किसी उपयोगकर्ता से Chat ऐप्लिकेशन कॉन्फ़िगरेशन का अनुरोध करना
अगर किसी अनुरोध को पूरा करने के लिए, दूसरे कॉन्फ़िगरेशन की ज़रूरत होती है जिसे सीधे Chat ऐप्लिकेशन में पूरा नहीं किया जा सकता, तो उपयोगकर्ता को सामान्य जवाब के तौर पर कॉन्फ़िगरेशन यूआरएल वापस करें या उसे निजी तौर पर इस फ़ॉर्म में दिखाएं:
{
"actionResponse": {
"type": "REQUEST_CONFIG",
"url": "CONFIGURATION_URL"
}
}
यह Google Chat को उपयोगकर्ता को एक निजी प्रॉम्प्ट दिखाने के लिए कहता है. इस प्रॉम्प्ट में CONFIGURATION_URL एक लिंक होता है, ताकि उपयोगकर्ता पुष्टि, अनुमति या कॉन्फ़िगरेशन के लिए इस लिंक पर जा सके. REQUEST_CONFIG रिस्पॉन्स, एक सामान्य रिस्पॉन्स मैसेज के साथ म्यूचुअली एक्सक्लूसिव होता है. किसी भी टेक्स्ट, कार्ड या दूसरे एट्रिब्यूट को अनदेखा किया जाता है.
कॉन्फ़िगरेशन का अनुरोध पूरा करें
आपके Chat ऐप्लिकेशन को मिलने वाले हर
MESSAGE इंटरैक्शन इवेंट में एक configCompleteRedirectUrl पैरामीटर भी शामिल होता है. इस यूआरएल को आपके कॉन्फ़िगरेशन यूआरएल में कोड में बदला जाना चाहिए, ताकि प्रोसेस पूरी होने पर इसका इस्तेमाल किया जा सके. इस यूआरएल पर रीडायरेक्ट करने से, Google Chat को पता चलता है कि कॉन्फ़िगरेशन का अनुरोध पूरा हो गया है.
आपका Chat ऐप्लिकेशन शुरू होने पर, फ़्लो, मिलने वाले मैसेज के हिसाब से तय होता है. @app help जैसे मैसेज के जवाब में, Chat ऐप्लिकेशन को अतिरिक्त कॉन्फ़िगरेशन की ज़रूरत
के बिना मैसेज के साथ जवाब देना चाहिए.
जब किसी उपयोगकर्ता को ओरिजनल मैसेज में दिए गए configCompleteRedirectUrl पर रीडायरेक्ट किया जाता है, तो Google Chat यह तरीका अपनाता है:
- शुरुआत करने वाले उपयोगकर्ता को दिखने वाले प्रॉम्प्ट को हमेशा के लिए मिटाएं.
- ओरिजनल मैसेज को सार्वजनिक में बदलें, ताकि वह स्पेस के अन्य सदस्यों को दिखे.
- उसी Chat ऐप्लिकेशन को दूसरी बार मूल मैसेज भेजें.
configCompleteRedirectUrl पर जाने से सिर्फ़ एक उपयोगकर्ता मैसेज पर असर पड़ता है.
अगर किसी उपयोगकर्ता ने Chat ऐप्लिकेशन को कई बार मैसेज भेजने की कोशिश की और इस वजह से उसे कई अनुरोध मिले, तो किसी खास अनुरोध पर क्लिक करने और पुष्टि करने और कॉन्फ़िगरेशन की प्रक्रिया पूरी करने पर सिर्फ़ उसी मैसेज पर असर पड़ेगा. हालांकि, अन्य मैसेज नहीं बदले जाएंगे.
जब इस तरह से MESSAGE इंटरैक्शन इवेंट फिर से भेजा जाता है, तो यह मूल इवेंट के जैसा होना चाहिए. हालांकि, कुछ मामलों में MESSAGE इंटरैक्शन इवेंट अलग-अलग हो सकते हैं. उदाहरण के लिए, अगर किसी मैसेज में Chat ऐप्लिकेशन A और चैट ऐप्लिकेशन B, दोनों का ज़िक्र है, तो उपयोगकर्ता उस मैसेज में बदलाव कर सकता है. हालांकि, इसके लिए ज़रूरी है कि Chat ऐप्लिकेशन B, चैट ऐप्लिकेशन B से पुष्टि करने से पहले सामान्य मैसेज का जवाब देता हो. इस मामले में,
Chat ऐप्लिकेशन B को बदलाव किया गया मैसेज टेक्स्ट तब मिलेगा, जब
उपयोगकर्ता पुष्टि और कॉन्फ़िगरेशन पूरा कर लेगा.
Chat के बाहर Chat उपयोगकर्ता की पुष्टि करें
कुछ मामलों में, जैसे कि किसी एपीआई के लिए OAuth की अनुमति का अनुरोध करने पर, आपके ऐप्लिकेशन को उपयोगकर्ता की पहचान को बनाए रखते हुए, उसे Chat के बाहर के किसी यूआरएल से लिंक करना होगा. ऐसे मामलों में उपयोगकर्ता की पहचान करने का सबसे अच्छा तरीका, डेस्टिनेशन ऐप्लिकेशन को Google साइन इन से सुरक्षित रखना है.
यूज़र आईडी पाने के लिए, साइन इन के दौरान मिले आइडेंटिटी टोकन का इस्तेमाल करें. sub दावे में उपयोगकर्ता का यूनीक आईडी शामिल होता है. साथ ही, इसे Google Chat के यूज़र आईडी से जोड़ा जा सकता है.
हालांकि दो आईडी बिलकुल एक जैसे नहीं होते हैं, लेकिन उन्हें लागू किया जा सकता है. sub के दावे की वैल्यू को Google Chat users/{user} पर लागू करने के लिए, वैल्यू से पहले users/ जोड़ें. उदाहरण के लिए, 123 की दावा करने की वैल्यू, आपके Chat ऐप्लिकेशन के मैसेज में मौजूद उपयोगकर्ता नाम users/123 के बराबर है.
मिलते-जुलते विषय
- MyProfile ऐप्लिकेशन उदाहरण, उपयोगकर्ता की पहचान करने के लिए 'Google साइन-इन' रिस्पॉन्स से मिले आइडेंटिटी टोकन का इस्तेमाल करता है.