- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- MessageReplyOption
- इसे आज़माएं!
Google Chat के स्पेस में मैसेज भेजता है. उदाहरण के लिए, मैसेज भेजना देखें.
create()
तरीके के लिए, उपयोगकर्ता की पुष्टि या ऐप्लिकेशन की पुष्टि करना ज़रूरी है. Chat, मैसेज भेजने वाले व्यक्ति को अलग-अलग एट्रिब्यूट देता है. यह इस बात पर निर्भर करता है कि अनुरोध में पुष्टि किस तरह की है.
इस इमेज में दिखाया गया है कि ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करने पर, Chat किसी मैसेज को कैसे एट्रिब्यूट करता है. Chat, Chat ऐप्लिकेशन को मैसेज भेजने वाले के तौर पर दिखाता है. मैसेज के कॉन्टेंट में टेक्स्ट (text
), कार्ड (cardsV2
), और ऐक्सेसरी विजेट (accessoryWidgets
) शामिल हो सकते हैं.
इस इमेज में दिखाया गया है कि उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करने पर, Chat किसी मैसेज को कैसे एट्रिब्यूट करता है. Chat, उपयोगकर्ता को मैसेज भेजने वाले के तौर पर दिखाता है. साथ ही, मैसेज में Chat ऐप्लिकेशन का नाम दिखाकर, उसे एट्रिब्यूट करता है. मैसेज के कॉन्टेंट में सिर्फ़ टेक्स्ट (text
) हो सकता है.
मैसेज का साइज़ ज़्यादा से ज़्यादा 32,000 बाइट होना चाहिए. इसमें मैसेज का कॉन्टेंट भी शामिल है.
वेबहुक के अनुरोधों के लिए, जवाब में पूरा मैसेज शामिल नहीं होता. अनुरोध में दी गई जानकारी के अलावा, जवाब सिर्फ़ name
और thread.name
फ़ील्ड में अपने-आप जानकारी भरता है.
एचटीटीपी अनुरोध
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
parent |
ज़रूरी है. उस स्पेस का नाम जिसमें मैसेज बनाना है. फ़ॉर्मैट: |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
threadKey |
ज़रूरी नहीं. बंद कर दिया गया है: इसके बजाय, |
request |
ज़रूरी नहीं. इस मैसेज के लिए यूनीक अनुरोध आईडी. मौजूदा अनुरोध आईडी की जानकारी देने पर, नया मैसेज बनाने के बजाय उस आईडी से बनाया गया मैसेज दिखता है. |
message |
ज़रूरी नहीं. इससे पता चलता है कि कोई मैसेज, थ्रेड शुरू करता है या किसी थ्रेड का जवाब देता है. यह सुविधा सिर्फ़ नाम वाले स्पेस में काम करती है. उपयोगकर्ता के इंटरैक्शन का जवाब देते समय, इस फ़ील्ड को अनदेखा कर दिया जाता है. किसी थ्रेड में होने वाले इंटरैक्शन के लिए, जवाब उसी थ्रेड में बनाया जाता है. ऐसा न करने पर, जवाब एक नई थ्रेड के तौर पर बन जाता है. |
message |
ज़रूरी नहीं. मैसेज के लिए कस्टम आईडी. इससे 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 गड़बड़ी का मैसेज दिखता है. |