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