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

يشرح هذا الدليل طريقة استخدام الطريقة 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/[email protected]/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.