- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- MessageReplyOption
- इसे आज़माएं!
Google Chat के स्पेस में मैसेज बनाता है. टेक्स्ट और कार्ड के साथ-साथ मैसेज का ज़्यादा से ज़्यादा साइज़ 32,000 बाइट हो सकता है. उदाहरण के लिए, मैसेज भेजें देखें.
इस तरीके को कॉल करने के लिए पुष्टि करना ज़रूरी है. साथ ही, यह पुष्टि करने के इन तरीकों के साथ काम करता है:
- मैसेज के लिए, उपयोगकर्ता की पुष्टि करने या ऐप्लिकेशन की पुष्टि करने की सुविधा उपलब्ध है.
- कार्ड मैसेज के लिए, सिर्फ़ ऐप्लिकेशन की पुष्टि की जा सकती है. (सिर्फ़ Chat ऐप्लिकेशन ही कार्ड मैसेज बना सकते हैं.)
एचटीटीपी अनुरोध
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 गड़बड़ी दिखती है. |