Method: users.spaces.threads.updateThreadReadState

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

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

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

طلب HTTP

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

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

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

المعلمات
threadReadState.name

string

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

التنسيق: users/{user}/spaces/{space}/threads/{thread}/threadReadState

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

المعلمات
updateMask

string (FieldMask format)

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

  • lastReadTime

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

لوضع علامة "مقروءة" على سلسلة المحادثات، اضبط lastReadTime على طابع زمني يساوي وقت إنشاء آخر رسالة أو يقع بعده. يتم فرض الطوابع الزمنية المستقبلية على وقت الطلب الحالي. يؤدي ضبط طابع زمني سالب (قبل 1970-01-01T00:00:00Z) إلى ظهور الخطأ INVALID_ARGUMENT.

نص الطلب

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

نص الاستجابة

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

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

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

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

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