Method: spaces.messages.patch

किसी मैसेज को अपडेट करता है. patch और update के तरीकों में अंतर है. patch तरीके में patch अनुरोध का इस्तेमाल किया जाता है, जबकि update तरीके में put अनुरोध का इस्तेमाल किया जाता है. हमारा सुझाव है कि आप patch तरीके का इस्तेमाल करें. उदाहरण के लिए, मैसेज अपडेट करना देखें.

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

  • अनुमति के दायरे के साथ ऐप्लिकेशन की पुष्टि:

    • https://www.googleapis.com/auth/chat.bot
  • अनुमति के इनमें से किसी एक दायरे के साथ उपयोगकर्ता की पुष्टि:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (सिर्फ़ इंपोर्ट मोड में स्पेस)

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

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

PATCH https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}

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

पाथ पैरामीटर

पैरामीटर
message.name

string

आइडेंटिफ़ायर. मैसेज का रिसॉर्स नेम.

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

यहां {space}, उस स्पेस का आईडी है जहां मैसेज पोस्ट किया गया है और {message}, मैसेज के लिए सिस्टम से असाइन किया गया आईडी है. उदाहरण के लिए, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

मैसेज बनाते समय कस्टम आईडी सेट करने पर, अनुरोध में मैसेज की जानकारी देने के लिए इस आईडी का इस्तेमाल किया जा सकता है. इसके लिए, {message} को clientAssignedMessageId फ़ील्ड की वैल्यू से बदलें. उदाहरण के लिए, spaces/AAAAAAAAAAA/messages/client-custom-name. ज़्यादा जानकारी के लिए, मैसेज का नाम देना लेख पढ़ें.

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

पैरामीटर
updateMask

string (FieldMask format)

ज़रूरी है. अपडेट करने के लिए फ़ील्ड पाथ. एक से ज़्यादा वैल्यू को कॉमा लगाकर अलग करें या सभी फ़ील्ड पाथ को अपडेट करने के लिए * का इस्तेमाल करें.

फ़िलहाल, ये फ़ील्ड पाथ इस्तेमाल किए जा सकते हैं:

allowMissing

boolean

ज़रूरी नहीं. अगर true और मैसेज नहीं मिलता है, तो नया मैसेज बनाया जाता है और updateMask को अनदेखा कर दिया जाता है. दिया गया मैसेज आईडी, क्लाइंट से असाइन किया गया होना चाहिए. ऐसा न होने पर, अनुरोध पूरा नहीं होगा.

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

अनुरोध के मुख्य भाग में Message का उदाहरण है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Message का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.