- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- MessageReplyOption
- इसे आज़माएं!
Google Chat के स्पेस में मैसेज भेजता है. उदाहरण के लिए, मैसेज भेजना देखें.
create()
तरीके के लिए, उपयोगकर्ता की पुष्टि या ऐप्लिकेशन की पुष्टि करना ज़रूरी है. Chat, मैसेज भेजने वाले व्यक्ति को अलग-अलग एट्रिब्यूट देता है. यह इस बात पर निर्भर करता है कि आपने पुष्टि करने के लिए किस तरह की प्रक्रिया का इस्तेमाल किया है.
इस इमेज में दिखाया गया है कि ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करने पर, Chat किसी मैसेज को कैसे एट्रिब्यूट करता है. Chat, मैसेज भेजने वाले व्यक्ति के तौर पर Chat ऐप्लिकेशन को दिखाता है. मैसेज के कॉन्टेंट में टेक्स्ट (text
), कार्ड (cardsV2
), और ऐक्सेसरी विजेट (accessoryWidgets
) शामिल हो सकते हैं.
इस इमेज में दिखाया गया है कि उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करने पर, Chat किसी मैसेज को कैसे एट्रिब्यूट करता है. Chat, उपयोगकर्ता को मैसेज भेजने वाले के तौर पर दिखाता है. साथ ही, मैसेज में Chat ऐप्लिकेशन का नाम दिखाकर, उसे एट्रिब्यूट करता है. मैसेज में सिर्फ़ टेक्स्ट (text
) शामिल किया जा सकता है.
मैसेज का साइज़ 32,000 बाइट से ज़्यादा नहीं होना चाहिए. इसमें मैसेज का कॉन्टेंट भी शामिल है.
webhook अनुरोधों के लिए, जवाब में पूरा मैसेज शामिल नहीं होता. जवाब में, अनुरोध में दी गई जानकारी के अलावा सिर्फ़ name
और thread.name
फ़ील्ड अपने-आप भर जाते हैं.
एचटीटीपी अनुरोध
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
ज़रूरी है. उस स्पेस का नाम जिसमें मैसेज बनाना है. फ़ॉर्मैट: |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
threadKey |
ज़रूरी नहीं. बंद कर दिया गया है: इसके बजाय, |
requestId |
ज़रूरी नहीं. इस मैसेज के लिए यूनीक अनुरोध आईडी. किसी मौजूदा अनुरोध आईडी की जानकारी देने पर, नया मैसेज बनाने के बजाय, उस आईडी से बनाया गया मैसेज दिखता है. |
messageReplyOption |
ज़रूरी नहीं. इससे पता चलता है कि कोई मैसेज, थ्रेड शुरू करता है या किसी थ्रेड का जवाब देता है. यह सुविधा सिर्फ़ नाम वाले स्पेस में काम करती है. उपयोगकर्ता के इंटरैक्शन का जवाब देते समय, इस फ़ील्ड को अनदेखा कर दिया जाता है. किसी थ्रेड में इंटरैक्शन करने पर, जवाब उसी थ्रेड में बनाया जाता है. ऐसा न करने पर, जवाब एक नई थ्रेड के तौर पर बन जाता है. |
messageId |
ज़रूरी नहीं. मैसेज के लिए कस्टम आईडी. इससे Chat ऐप्लिकेशन, मैसेज के रिसॉर्स के नाम (मैसेज के इस फ़ील्ड की वैल्यू इन ज़रूरी शर्तों के मुताबिक होनी चाहिए:
ज़्यादा जानकारी के लिए, मैसेज का नाम देना लेख पढ़ें. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में Message
का उदाहरण है.
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Message
का नया इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.create
ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.
MessageReplyOption
किसी मैसेज का जवाब देने का तरीका बताता है. आने वाले समय में, अन्य राज्यों में भी यह सुविधा उपलब्ध कराई जा सकती है.
Enums | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
डिफ़ॉल्ट. नई थ्रेड शुरू करता है. इस विकल्प का इस्तेमाल करने पर, शामिल किए गए किसी भी thread ID या को अनदेखा कर दिया जाता है. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
thread ID या से चुनी गई थ्रेड के जवाब के तौर पर मैसेज बनाता है. अगर ऐसा नहीं होता है, तो मैसेज की नई थ्रेड शुरू हो जाती है. |
REPLY_MESSAGE_OR_FAIL |
thread ID या से चुनी गई थ्रेड के जवाब के तौर पर मैसेज बनाता है. अगर किसी नए threadKey का इस्तेमाल किया जाता है, तो एक नई थ्रेड बन जाती है. अगर मैसेज नहीं बन पाता है, तो NOT_FOUND गड़बड़ी का मैसेज दिखता है. |