REST Resource: users.availability

সম্পদ: প্রাপ্যতা

গুগল চ্যাটে একজন ব্যবহারকারীর বর্তমান উপলব্ধতার তথ্য উপস্থাপন করে, যার মধ্যে তার অবস্থা (যেমন, সক্রিয়, দূরে, বিরক্ত করবেন না) এবং যেকোনো কাস্টম স্ট্যাটাস অন্তর্ভুক্ত থাকে।

JSON উপস্থাপনা 
{
  "name": string,
  "state": enum (State),
  "customStatus": {
    object (CustomStatus)
  },

  "doNotDisturbMetadata": {
    object (DoNotDisturbMetadata)
  }
}
ক্ষেত্র
name

string

শনাক্তকারী। ব্যবহারকারীর উপলব্ধতার রিসোর্স নাম।

ফর্ম্যাট: users/{user}/availability

{user} হলো People API বা Admin SDK ডিরেক্টরি API-তে থাকা Person-এর আইডি। উদাহরণস্বরূপ, users/123456789 ।

কলারকে বোঝানোর জন্য ব্যবহারকারীর ইমেল ঠিকানা বা me ছদ্মনাম হিসেবেও ব্যবহার করা যেতে পারে। উদাহরণস্বরূপ, users/user@example.com বা users/me ।

state

enum ( State )

শুধুমাত্র আউটপুট। ব্যবহারকারীর বর্তমান উপলব্ধতার অবস্থা।

customStatus

object ( CustomStatus )

ঐচ্ছিক। ব্যবহারকারীর নিজস্ব স্ট্যাটাস।

ইউনিয়ন ফিল্ড state_metadata । ব্যবহারকারীর উপলব্ধতার অবস্থার সাথে সম্পর্কিত অতিরিক্ত মেটাডেটা। state_metadata নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
doNotDisturbMetadata

object ( DoNotDisturbMetadata )

শুধুমাত্র আউটপুট। যদি ব্যবহারকারীর অবস্থা DO_NOT_DISTRUB-এ সেট করা থাকে, তাহলে মেটাডেটা।

রাজ্য

ব্যবহারকারীর বর্তমান উপলব্ধতার অবস্থা নির্দেশ করে।

এনাম
STATE_UNSPECIFIED ডিফল্ট মান। অবস্থাটি অনির্দিষ্ট।
ACTIVE সাম্প্রতিক কার্যকলাপ অনুযায়ী ব্যবহারকারী বর্তমানে সক্রিয় আছেন।
IDLE ব্যবহারকারী বর্তমানে নিষ্ক্রিয় আছেন। এই অবস্থাটি ACTIVE থাকার পর একটি নিষ্ক্রিয়তার সময়কালকে নির্দেশ করে, যার পরে এটি AWAY অবস্থায় রূপান্তরিত হতে পারে।
AWAY ব্যবহারকারী বর্তমানে অনুপস্থিত আছেন। এটি ACTIVE বা IDLE অবস্থায় একটি নির্দিষ্ট সময় ধরে নিষ্ক্রিয় থাকার পর স্বয়ংক্রিয়ভাবে সেট হতে পারে, অথবা ব্যবহারকারী এটি ম্যানুয়ালি সেট করতে পারেন। availability.markAsAway এর মাধ্যমে ম্যানুয়ালি সেট করা হলে, ব্যবহারকারীর কার্যকলাপ নির্বিশেষে এই অবস্থাটি বজায় থাকে।
DO_NOT_DISTURB ব্যবহারকারী 'ডু নট ডিস্টার্ব' অবস্থায় আছেন, যা ম্যানুয়ালি সেট করা হয়েছে।

DoNotDisturbMetadata

DO_NOT_DISTURB অ্যাভেইলেবিলিটি স্টেটের সাথে সম্পর্কিত মেটাডেটা, যা নির্দিষ্ট করে কখন স্টেটটির মেয়াদ শেষ হবে।

JSON উপস্থাপনা 
{
  "expirationTime": string
}
ক্ষেত্র
expirationTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়কাল পর্যন্ত ব্যবহারকারীকে DO_NOT_DISTURB হিসেবে চিহ্নিত করা উচিত, সেই সময়সীমা। এটি ভবিষ্যতের সর্বোচ্চ ১ বছর হতে পারে।

কাস্টম স্ট্যাটাস

গুগল চ্যাটে এটি একজন ব্যবহারকারীর নিজস্ব স্ট্যাটাস নির্দেশ করে। এর মধ্যে একটি সংক্ষিপ্ত টেক্সট মেসেজ এবং একটি ঐচ্ছিক ইমোজি থাকে, যা ব্যবহারকারী তার উপলব্ধতা সম্পর্কে আরও স্পষ্ট ধারণা দেওয়ার জন্য সেট করতে পারেন।

JSON উপস্থাপনা 
{
  "text": string,
  "emoji": {
    object (Emoji)
  },

  "expireTime": string,
  "ttl": string
}
ক্ষেত্র
text

string

আবশ্যক। কাস্টম স্ট্যাটাসের টেক্সট। এটি সর্বোচ্চ ৬৪ অক্ষরের একটি স্ট্রিং হবে।

emoji

object ( Emoji )

আবশ্যক। কাস্টম স্ট্যাটাসের ইমোজি। শুধুমাত্র ইউনিকোড ইমোজি সমর্থিত; কাস্টম ইমোজি সমর্থিত নয়।

ইউনিয়ন ফিল্ড expiration । কাস্টম স্ট্যাটাসের মেয়াদ শেষ হওয়ার সময়। এটি একটি অ্যাবসোলিউট টাইমস্ট্যাম্প অথবা টাইম-টু-লিভ ডিউরেশন হিসেবে নির্দিষ্ট করা যেতে পারে। expiration নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
expireTime

string ( Timestamp format)

কাস্টম স্ট্যাটাসের মেয়াদ শেষ হওয়ার টাইমস্ট্যাম্প।

ttl

string ( Duration format)

শুধুমাত্র ইনপুট। এটি হলো সেই মেয়াদকাল, যার পরে কাস্টম স্ট্যাটাসটির মেয়াদ শেষ হয়ে যাবে।

পদ্ধতি

get

 গুগল চ্যাটে কোনো ব্যবহারকারীর জন্য উপলব্ধতার তথ্য প্রদান করে।

markAsActive

 গুগল চ্যাটে ব্যবহারকারীকে ACTIVE হিসেবে চিহ্নিত করে।

markAsAway

 গুগল চ্যাটে ব্যবহারকারীকে AWAY হিসেবে চিহ্নিত করে।

markAsDoNotDisturb

 গুগল চ্যাটে ব্যবহারকারীকে DO_NOT_DISTURB হিসেবে চিহ্নিত করে।

patch

 মানুষের ব্যবহারের জন্য প্রাপ্যতার তথ্য হালনাগাদ করে।