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

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

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

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

Node.js

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

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

  • حدِّد نطاق تفويض 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

chat/client-libraries/cloud/update-space-read-state-user-cred.js
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.