Method: users.spaces.getSpaceReadState

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

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

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

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

GET https://chat.googleapis.com/v1/{name=users/*/spaces/*/spaceReadState}

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

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. उस स्पेस का नाम जिसकी रीड स्टेटस को वापस लाना है.

यह सिर्फ़ कॉल करने वाले उपयोगकर्ता के लिए, मैसेज पढ़े जाने की स्थिति देखने की सुविधा देता है.

कॉल करने वाले उपयोगकर्ता को रेफ़र करने के लिए, इनमें से कोई एक सेट करें:

  • me का दूसरा ईमेल पता. उदाहरण के लिए, users/me/spaces/{space}/spaceReadState.

  • Workspace खाते से जुड़ा ईमेल पता. उदाहरण के लिए, users/user@example.com/spaces/{space}/spaceReadState.

  • उनका यूज़र आईडी. उदाहरण के लिए, users/123456789/spaces/{space}/spaceReadState.

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

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य हिस्सा

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

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

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

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

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