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

يوضّح هذا الدليل كيفية استخدام طريقة get() في مورد SpaceReadState ضِمن Google Chat API للحصول على تفاصيل حول حالة القراءة الخاصة بالمستخدم في مساحة. للحصول على حالة قراءة رسالة في سلسلة رسائل، يُرجى الاطّلاع على الحصول على تفاصيل حول حالة قراءة سلسلة رسائل خاصة بمستخدم.

SpaceReadState المورد هو مورد فردي يمثّل تفاصيل حول آخر رسالة قرأها مستخدم محدّد في مساحة Google Chat.

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

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

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

• حدِّد نطاق إذن chat.users.readstate أو chat.users.readstate.readonly.
• استدعِ طريقة GetSpaceReadState() ، مع تمرير name لحالة قراءة المساحة للحصول على ما يتضمّن معرّف مستخدم أو اسم مستعار ومعرّف مساحة. لا يتيح الحصول على حالة قراءة المساحة سوى الحصول على حالة قراءة المستخدم الذي يجري الاتصال، ويمكن تحديدها من خلال ضبط أحد الخيارات التالية:
  • الاسم المستعار me على سبيل المثال، users/me/spaces/SPACE/spaceReadState.
  • عنوان البريد الإلكتروني في Workspace للمستخدم الذي يجري المكالمة على سبيل المثال، users/user@example.com/spaces/SPACE/spaceReadState.
  • معرّف المستخدم الذي يجري المكالمة على سبيل المثال، users/USER/spaces/SPACE/spaceReadState.

يحصل المثال التالي على حالة قراءة مساحة المستخدم الذي يجري الاتصال:

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

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

// This sample shows how to get the 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 request = {
    // Replace SPACE_NAME here
    name: 'users/me/spaces/SPACE_NAME/spaceReadState',
  };

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

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

await main();

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

تحصل Google Chat API على حالة القراءة المحدّدة للمساحة وتعرض مثيلاً من SpaceReadState.

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

• تعديل حالة قراءة المساحة للمستخدم الذي يجري المكالمة
• الحصول على حالة قراءة سلسلة المحادثات للمستخدم الذي يجري المكالمة: