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