يوضّح هذا الدليل كيفية استخدام الأسلوب
get()
في مورد ThreadReadState
من Google Chat API للحصول على تفاصيل
حول حالة قراءة المستخدم ضمن سلسلة محادثات. للاطّلاع على حالة قراءة
رسالة في مساحة، يُرجى الاطّلاع على مقالة
الحصول على تفاصيل عن حالة قراءة مساحة المستخدم.
مورد ThreadReadState
هو مورد وحيد يمثّل تفاصيل حول
آخر رسالة مقروءة لمستخدم محدّد في سلسلة محادثات على Google Chat.
المتطلبات الأساسية
Node.js
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- فعِّل Google Chat API وضبطها باستخدام اسم و رمز ووصف لتطبيق Chat.
- تثبيت Node.js Cloud Client Library.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ النموذج في هذه
هذا الدليل، فاحفظ بيانات الاعتماد كملف JSON اسمه
client_secrets.json
في الدليل المحلي.
- اختَر نطاق تفويض يتيح مصادقة المستخدمين.
الحصول على حالة قراءة سلسلة المحادثات الخاصة بالمستخدم المتصل
للحصول على تفاصيل حول حالة القراءة للمستخدم في سلسلة رسائل، يُرجى تضمين التالية في طلبك:
- تحديد
chat.users.readstate
أوchat.users.readstate.readonly
نطاق التفويض. - عليك استدعاء
GetThreadReadState()
وهو تمريرname
لحالة قراءة سلسلة المحادثات للحصول على رقم تعريف المستخدم أو العنوان البديل للبريد الإلكتروني ورقم تعريف المساحة لا يتوافق الحصول على حالة قراءة سلسلة المحادثات إلا مع الحصول على حالة قراءة المستخدم المتصل، والتي يمكن تحديدها عن طريق اضبط أيًا مما يلي:- العنوان البديل للبريد الإلكتروني
me
على سبيل المثال،users/me/spaces/SPACE/threads/THREAD/threadReadState
. - عنوان البريد الإلكتروني للمستخدم في Workspace على سبيل المثال:
users/user@example.com/spaces/SPACE/threads/THREAD/threadReadState
- رقم تعريف المستخدم الخاص بالمستخدم المتصل على سبيل المثال،
users/USER/spaces/SPACE/threads/THREAD/threadReadState
.
- العنوان البديل للبريد الإلكتروني
يحصل المثال التالي على حالة قراءة سلسلة المحادثات الخاصة بالمستخدم المتصل:
Node.js
لتشغيل هذا النموذج، استبدل ما يلي:
SPACE_NAME
: رقم التعريف الوارد في المساحةname
يمكنك الحصول على المعرّف من خلال استدعاء الأسلوبListSpaces()
أو من عنوان URL للمساحة.THREAD_NAME
: رقم التعريف منname
سلسلة المحادثات يمكنك الحصول على المعرّف من نص الاستجابة الذي تم إرجاعه بعد إنشاء بشكل غير متزامن مع Chat API، أو من خلال اسم مخصّص المخصص للرسالة عند الإنشاء.
تحصل Google Chat API على حالة قراءة سلسلة المحادثات المحدّدة وتُرجِع
مثيلًا من
ThreadReadState
.