Method: users.spaces.threads.getThreadReadState

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

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

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

طلب HTTP

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

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

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

المعلمات
name

string

مطلوب. اسم المورد لحالة قراءة سلسلة المحادثات المطلوب استرجاعها

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

للإشارة إلى المستخدم المتصل، اضبط أحد الخيارَين التاليَين:

  • الاسم المستعار me مثلاً: users/me/spaces/{space}/threads/{thread}/threadReadState

  • عنوان البريد الإلكتروني على Workspace مثلاً: users/user@example.com/spaces/{space}/threads/{thread}/threadReadState

  • رقم تعريف المستخدم مثلاً: users/123456789/spaces/{space}/threads/{thread}/threadReadState

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

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

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

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

يتطلب أحد نطاقات OAuth التالية:

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

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