Method: users.availability.patch

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

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

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

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

طلب HTTP

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

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

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

المعلمات
availability.name

string

المعرّف. اسم المرجع الخاص بمدى توفّر المستخدم.

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

‫{user} هو معرّف "الشخص" في People API أو واجهة برمجة تطبيقات دليل Admin SDK. مثلاً: users/123456789

يمكن أيضًا استخدام عنوان البريد الإلكتروني للمستخدم أو me كاسم مستعار للإشارة إلى المتصل. على سبيل المثال، users/user@example.com أو users/me.

مَعلمات طلب البحث

المعلمات
updateMask

string (FieldMask format)

الحقل مطلوب. قائمة الحقول التي سيتم تعديلها. الحقل الوحيد الذي يمكن تعديله هو customStatus.

نص الطلب

يحتوي نص الطلب على مثال Availability.

نص الاستجابة

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

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

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

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

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