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

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

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

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

Node.js

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

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

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

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

Node.js

chat/client-libraries/cloud/get-thread-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 thread read state for a space and 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 and THREAD_NAME here
    name: 'users/me/spaces/SPACE_NAME/threads/THREAD_NAME/threadReadState'
  };

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

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

main().catch(console.error);

لتشغيل هذا العيّنة، استبدِل ما يلي:

  • SPACE_NAME: رقم التعريف من name المساحة يمكنك الحصول على المعرّف من خلال استدعاء الوسيطة ListSpaces() أو من عنوان URL للمساحة.
  • THREAD_NAME: رقم التعريف من name سلسلة المحادثات يمكنك الحصول على رقم التعريف من نص الاستجابة الذي يتم إرجاعه بعد إنشاء رسالة بشكل غير متزامن باستخدام Chat API، أو باستخدام الاسم المخصّص الذي تمّ تعيينه للرسالة عند إنشائها.

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