تعديل حالة قراءة مساحة المستخدم

يوضّح هذا الدليل كيفية استخدام الأسلوب update() في مورد SpaceReadState من Google Chat API لوضع علامة "تمت القراءة" أو "لم تتم القراءة" على المساحات.

مورد SpaceReadState هو مورد فردي يمثّل تفاصيل عن آخر رسالة مقروءة لمستخدِم محدّد في مساحة على Google Chat.

المتطلبات الأساسية

تعديل حالة قراءة مساحة المستخدم المتصل

لتعديل حالة قراءة مستخدم في مساحة، أدرِج ما يلي في طلبك:

• حدِّد نطاق تفويض 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 لمطابقة آخر وقت لإنشاء الرسالة. يُرجى ملاحظة أنّ حالة قراءة المساحة تؤثر فقط في حالة قراءة الرسائل التي تظهر في المحادثة ذات المستوى الأعلى في المساحة. ولا تتأثّر الردود في سلاسل المحادثات بهذا الطابع الزمني، بل تعتمد على حالة قراءة سلسلة المحادثات بدلاً من ذلك.

يعدِّل المثال التالي حالة قراءة مساحة المستخدم المتصل:

import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.users.readstate'];

// This sample shows how to update a space read state for the calling user
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const timestamp = new Date('2000-01-01').getTime();
  const request = {
    spaceReadState: {
      // Replace SPACE_NAME here
      name: 'users/me/spaces/SPACE_NAME/spaceReadState',
      lastReadTime: {
        seconds: Math.floor(timestamp / 1000),
        nanos: (timestamp % 1000) * 1000000
      }
    },
    updateMask: {
      // The field paths to update.
      paths: ['last_read_time']
    }
  };

  // Make the request
  const response = await chatClient.updateSpaceReadState(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

لتشغيل هذا النموذج، استبدِل SPACE_NAME برقم التعريف من name الخاص بالمساحة. يمكنك الحصول على المعرّف من خلال استدعاء الطريقة ListSpaces() أو من عنوان URL للمساحة.

تعدِّل Google Chat API حالة قراءة المساحة المحدّدة وتُرجِع مثيلًا من SpaceReadState.

مواضيع ذات صلة

• الحصول على حالة قراءة مساحة المستخدم المتصل
• الحصول على حالة قراءة سلسلة المحادثات للمستخدم المتصل