Method: spaces.messages.create

यह Google Chat पर मौजूद स्पेस में मैसेज भेजेगा. उदाहरण के लिए, मैसेज भेजना देखें.

create() तरीके के लिए, उपयोगकर्ता की पुष्टि या ऐप्लिकेशन की पुष्टि करना ज़रूरी है. Chat, मैसेज भेजने वाले व्यक्ति को अलग-अलग एट्रिब्यूट देता है. यह इस बात पर निर्भर करता है कि अनुरोध में पुष्टि किस तरह की है.

इस इमेज में दिखाया गया है कि ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करने पर, Chat किसी मैसेज को कैसे एट्रिब्यूट करता है. Chat, मैसेज भेजने वाले के तौर पर Chat ऐप्लिकेशन दिखाता है. मैसेज के कॉन्टेंट में टेक्स्ट (text), कार्ड (cardsV2), और ऐक्सेसरी विजेट (accessoryWidgets) शामिल हो सकते हैं.

ऐप्लिकेशन की पुष्टि करने के बाद भेजा गया मैसेज

इस इमेज में दिखाया गया है कि उपयोगकर्ता की पुष्टि करने की सुविधा का इस्तेमाल करने पर, Chat किसी मैसेज को कैसे एट्रिब्यूट करता है. Chat, उपयोगकर्ता को मैसेज भेजने वाले के तौर पर दिखाता है. साथ ही, मैसेज में Chat ऐप्लिकेशन का नाम दिखाकर, उसे एट्रिब्यूट करता है. मैसेज में सिर्फ़ टेक्स्ट (text) शामिल किया जा सकता है.

उपयोगकर्ता की पुष्टि करने के साथ मैसेज भेजा गया

मैसेज का साइज़ 32,000 बाइट से ज़्यादा नहीं होना चाहिए. इसमें मैसेज का कॉन्टेंट भी शामिल है.

एचटीटीपी अनुरोध

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. उस स्पेस का नाम जिसमें मैसेज बनाना है.

फ़ॉर्मैट: spaces/{space}

क्वेरी पैरामीटर

पैरामीटर
threadKey
(deprecated)

string

ज़रूरी नहीं. बंद कर दिया गया है: इसके बजाय, thread.thread_key का इस्तेमाल करें. थ्रेड का आईडी. ज़्यादा से ज़्यादा 4,000 वर्णों का इस्तेमाल किया जा सकता है. किसी थ्रेड को शुरू करने या उसमें कुछ जोड़ने के लिए, मैसेज बनाएं और threadKey या thread.name तय करें. इस्तेमाल के उदाहरण के लिए, मैसेज थ्रेड शुरू करना या उसका जवाब देना देखें.
requestId

string

ज़रूरी नहीं. इस मैसेज के लिए यूनीक अनुरोध आईडी. मौजूदा अनुरोध आईडी की जानकारी देने पर, नया मैसेज बनाने के बजाय उस आईडी से बनाया गया मैसेज दिखता है.
messageReplyOption

enum (MessageReplyOption)

ज़रूरी नहीं. इससे पता चलता है कि कोई मैसेज, थ्रेड शुरू करता है या किसी थ्रेड पर जवाब देता है. यह सुविधा सिर्फ़ नाम वाले स्पेस में काम करती है.
messageId

string

ज़रूरी नहीं. किसी मैसेज के लिए कस्टम आईडी. इससे Chat ऐप्लिकेशन को मैसेज के संसाधन नाम (मैसेज name फ़ील्ड में दिखाया गया) में, सिस्टम से असाइन किए गए आईडी को सेव किए बिना, मैसेज पाने, अपडेट करने या उसे मिटाने की सुविधा मिलती है.

इस फ़ील्ड की वैल्यू इन ज़रूरी शर्तों के मुताबिक होनी चाहिए:

  • client- से शुरू होता है. उदाहरण के लिए, client-custom-name एक मान्य कस्टम आईडी है, लेकिन custom-name नहीं.
  • इसमें ज़्यादा से ज़्यादा 63 वर्ण हो सकते हैं. साथ ही, इसमें सिर्फ़ अंग्रेज़ी के छोटे अक्षर, संख्याएं, और हाइफ़न का इस्तेमाल किया जा सकता है.
  • स्पेस में यूनीक हो. कोई चैट ऐप्लिकेशन, अलग-अलग मैसेज के लिए एक ही कस्टम आईडी का इस्तेमाल नहीं कर सकता.

ज़्यादा जानकारी के लिए, मैसेज का नाम देना लेख पढ़ें.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में 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 या threadKey को अनदेखा कर दिया जाता है.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD thread ID या threadKey के बताए गए थ्रेड के जवाब के तौर पर मैसेज बनाता है. अगर यह काम नहीं करता, तो मैसेज नया थ्रेड शुरू करता है.
REPLY_MESSAGE_OR_FAIL thread ID या threadKey से चुनी गई थ्रेड के जवाब के तौर पर मैसेज बनाता है. अगर नए threadKey का इस्तेमाल किया जाता है, तो नया थ्रेड बन जाता है. अगर मैसेज नहीं बन पाता है, तो NOT_FOUND गड़बड़ी का मैसेज दिखता है.