Method: spaces.messages.create

Google Chat के स्पेस में मैसेज बनाता है. टेक्स्ट और कार्ड के साथ-साथ मैसेज का ज़्यादा से ज़्यादा साइज़ 32,000 बाइट हो सकता है. उदाहरण के लिए, मैसेज भेजें देखें.

इस तरीके को कॉल करने के लिए पुष्टि करना ज़रूरी है. साथ ही, यह पुष्टि करने के इन तरीकों के साथ काम करता है:

  • मैसेज के लिए, उपयोगकर्ता की पुष्टि करने या ऐप्लिकेशन की पुष्टि करने की सुविधा उपलब्ध है.
  • कार्ड मैसेज के लिए, सिर्फ़ ऐप्लिकेशन की पुष्टि की जा सकती है. (सिर्फ़ Chat ऐप्लिकेशन ही कार्ड मैसेज बना सकते हैं.)

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

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