Method: users.availability.get

Google Chat में किसी व्यक्ति की उपलब्धता की जानकारी दिखाता है. उदाहरण के लिए, इसका इस्तेमाल यह देखने के लिए किया जा सकता है कि कोई उपयोगकर्ता ऑनलाइन है या नहीं. इसके अलावा, इसका इस्तेमाल उपयोगकर्ता के कस्टम स्टेटस मैसेज को वापस पाने के लिए भी किया जा सकता है.

इस तरीके से, सिर्फ़ पुष्टि किए गए उपयोगकर्ता की उपलब्धता की जानकारी मिलती है.

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. उपलब्धता का संसाधन नाम, जिसे वापस पाना है.

फ़ॉर्मैट: users/{user}/availability

{user}, People API या Admin SDK Directory API में मौजूद व्यक्ति का आईडी है. उदाहरण के लिए, users/123456789.

उपयोगकर्ता के ईमेल पते या me का इस्तेमाल, कॉल करने वाले व्यक्ति के लिए उपनाम के तौर पर भी किया जा सकता है. उदाहरण के लिए, users/user@example.com या users/me.

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

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

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

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

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

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

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

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