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

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

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

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

Node.js

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

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

  • تحديد chat.users.readstate أو chat.users.readstate.readonly نطاق التفويض.
  • عليك استدعاء GetThreadReadState() وهو تمرير 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.