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

يوضّح هذا الدليل كيفية استخدام الأسلوب 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.