Method: users.availability.markAsActive

يتم وضع علامة ACTIVE على المستخدم في Google Chat.

يتم ضبط حالة توفّر المستخدم على ACTIVE. تستمر الحالة ACTIVE حتى تاريخ انتهاء الصلاحية المحدّد، وعندها تصبح حالة المستخدم AWAY. يُرجى العِلم أنّه إذا كان المستخدم يستخدم Chat بشكل نشط، قد تمتد مدة الحالة ACTIVE إلى ما بعد تاريخ انتهاء الصلاحية المقدَّم.

لا تعدِّل هذه الطريقة سوى حالة توفّر المستخدم الذي تم التحقّق من هويته.

يتطلب مصادقة المستخدم باستخدام نطاق الأذونات:

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

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى 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)

المدة الزمنية من الوقت الحالي حتى انتهاء صلاحية الحالة "نشط" يمكن أن تؤدي مدة البقاء (TTL) القصيرة الأجل إلى إعادة ضبط حالة المستخدم بشكل فعّال لتستند إلى النشاط بعد هذه المدة القصيرة.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال Availability.

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.