Method: users.availability.get

تعرض هذه الطريقة معلومات مدى التوفّر لمستخدم بشري في Google Chat. على سبيل المثال، يمكن استخدام هذه الطريقة لمعرفة ما إذا كان المستخدم متصلاً بالإنترنت أو غير متوفّر، أو لاسترداد رسالة الحالة المخصّصة.

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

يتطلّب مصادقة المستخدم باستخدام أحد نطاقات التفويض التالية:

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

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
name

string

الحقل مطلوب. اسم المورد الخاص بمعلومات التوفّر المطلوب استردادها.

التنسيق: users/{user}/availability

‫{user} هو معرّف "الشخص" في People API أو واجهة برمجة تطبيقات دليل Admin SDK. مثلاً: 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

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