Method: users.spaces.updateSpaceReadState

تعديل حالة قراءة المستخدم ضمن مساحة، وتُستخدَم لتحديد الرسائل المقروءة وغير المقروءة للاطّلاع على مثال، راجِع تعديل حالة قراءة مساحة المستخدم.

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

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

طلب HTTP

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

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

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

المعلمات
spaceReadState.name

string

اسم المورد لحالة قراءة المساحة

التنسيق: users/{user}/spaces/{space}/spaceReadState

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

المعلمات
updateMask

string (FieldMask format)

مطلوب. مسارات الحقول التي سيتم تعديلها مسارات الحقول المتوافقة حاليًا:

  • lastReadTime

عندما يكون lastReadTime قبل وقت إنشاء آخر رسالة، تظهر المساحة على أنّها غير مقروءة في واجهة المستخدم.

لوضع علامة "تمت القراءة" على المساحة، اضبط lastReadTime على أي قيمة لاحقة (أكبر) من وقت إنشاء آخر رسالة. يتم إجبار lastReadTime على مطابقة وقت إنشاء آخر رسالة. يُرجى العِلم أنّ حالة قراءة المساحة لا تؤثّر إلا في حالة قراءة الرسائل الظاهرة في محادثة المستوى الأعلى للمساحة. لا تتأثر الردود في سلاسل المحادثات بهذا الطابع الزمني، بل تعتمد بدلاً من ذلك على حالة قراءة سلسلة المحادثات.

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

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