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