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

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

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

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

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

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

• حدِّد نطاق إذن 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.

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

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 على حالة القراءة المحدّدة لسلسلة المحادثات وتعرض مثيلاً من ThreadReadState.

مواضيع ذات صلة

• تعديل حالة القراءة في مساحة المستخدم الذي يجري المكالمة
• الحصول على حالة قراءة مساحة المستخدم الذي يجري المكالمة: