Method: users.availability.markAsActive

इस कुकी से, उपयोगकर्ता को Google Chat में ACTIVE के तौर पर मार्क किया जाता है.

यह कुकी, उपयोगकर्ता की उपलब्धता की स्थिति को ACTIVE पर सेट करती है. ACTIVE स्थिति, तय की गई समयसीमा तक रहती है. इसके बाद, उपयोगकर्ता की स्थिति AWAY हो जाती है. ध्यान दें कि अगर उपयोगकर्ता Chat का इस्तेमाल कर रहा है, तो ACTIVE स्थिति की अवधि, दी गई समयसीमा से ज़्यादा हो सकती है.

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

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. उपलब्धता का रिसॉर्स नाम, जिसे चालू के तौर पर मार्क करना है. फ़ॉर्मैट: users/{user}/availability

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

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

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

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{

  "expireTime": string,
  "ttl": string
}
फ़ील्ड
यूनियन फ़ील्ड expiration. 'उपलब्ध है' स्थिति के लिए, रजिस्ट्रेशन खत्म होने की तारीख. स्टेटस के खत्म होने के बाद, उपयोगकर्ता को 'अभी उपलब्ध नहीं है' के तौर पर मार्क कर दिया जाएगा. अगर समयसीमा खत्म होने की कोई तारीख नहीं दी गई है, तो 'चालू है' स्थिति, मौजूदा समय से 30 मिनट बाद खत्म हो जाएगी. expiration इनमें से सिर्फ़ एक हो सकता है:
expireTime

string (Timestamp format)

ऐक्टिव स्थिति खत्म होने का सटीक टाइमस्टैंप.
ttl

string (Duration format)

मौजूदा समय से लेकर, ACTIVE स्थिति के खत्म होने तक की अवधि. कम टीटीएल का इस्तेमाल करने से, उपयोगकर्ता की स्थिति को इस छोटी अवधि के बाद गतिविधि के आधार पर रीसेट किया जा सकता है.

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

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

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

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

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

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