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

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

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

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

Node.js

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

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

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

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

Node.js

chat/client-libraries/cloud/get-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.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);
}

main().catch(console.error);

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

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