Method: users.spaces.threads.updateThreadReadState

यह कुकी, थ्रेड में उपयोगकर्ता के पढ़े गए मैसेज की स्थिति को अपडेट करती है. इसका इस्तेमाल, पढ़े गए और नहीं पढ़े गए मैसेज की पहचान करने के लिए किया जाता है. उदाहरण के लिए, किसी उपयोगकर्ता के थ्रेड को पढ़े जाने की स्थिति अपडेट करना लेख पढ़ें.

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

  • https://www.googleapis.com/auth/chat.users.readstate

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

PATCH https://chat.googleapis.com/v1/{threadReadState.name=users/*/spaces/*/threads/*/threadReadState}

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

पाथ पैरामीटर

पैरामीटर
threadReadState.name

string

थ्रेड के पढ़े जाने की स्थिति के संसाधन का नाम.

फ़ॉर्मैट: users/{user}/spaces/{space}/threads/{thread}/threadReadState

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

पैरामीटर
updateMask

string (FieldMask format)

ज़रूरी है. अपडेट किए जाने वाले फ़ील्ड पाथ. फ़िलहाल, ये फ़ील्ड पाथ इस्तेमाल किए जा सकते हैं:

  • lastReadTime

अगर lastReadTime की वैल्यू, सबसे नए मैसेज के बनाए जाने के समय से पहले की है, तो यूज़र इंटरफ़ेस (यूआई) में थ्रेड को 'नहीं पढ़ा गया' के तौर पर दिखाया जाता है.

थ्रेड को 'पढ़ा गया' के तौर पर मार्क करने के लिए, lastReadTime को उस टाइमस्टैंप पर सेट करें जो सबसे नए मैसेज के बनाए जाने के समय के बराबर या उसके बाद का हो. आगे की तारीख के टाइमस्टैंप को मौजूदा अनुरोध के समय के हिसाब से सेट किया जाता है. नेगेटिव टाइमस्टैंप (1970-01-01T00:00:00Z से पहले) सेट करने पर, INVALID_ARGUMENT गड़बड़ी का मैसेज दिखता है.

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

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

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

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

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.users.readstate

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