البحث عن مساحة رسالة مباشرة (DM)

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

يمثّل المورد Space مكانًا يمكن فيه للمستخدمين وتطبيقات Chat إرسال الرسائل ومشاركة الملفات والتعاون. تتوفّر عدة أنواع من المساحات:

• الرسائل المباشرة هي محادثات بين مستخدمَين أو بين مستخدم وتطبيق Chat.
• المحادثات الجماعية هي محادثات بين ثلاثة مستخدمين أو أكثر وتطبيقات Chat.
• المساحات المسماة هي مساحات دائمة يرسل فيها المستخدمون الرسائل ويشاركون الملفات ويتعاونون.

عندما يثبّت مشرف Google Workspace تطبيقًا في Chat لجميع المستخدمين في مؤسسة Google Workspace، ينشئ Google Chat رسالة مباشرة بين تطبيق Chat المثبَّت وكل مستخدم في المؤسسة.

تتيح المصادقة باستخدام مصادقة التطبيق لتطبيق Chat الحصول على الرسائل المباشرة التي يمكنه الوصول إليها في Google Chat (مثل الرسائل المباشرة التي يشارك فيها). تؤدي المصادقة باستخدام مصادقة المستخدم إلى عرض الرسائل المباشرة التي يمكن للمستخدم الذي تمت المصادقة عليه الوصول إليها.

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

العثور على رسالة مباشرة

للعثور على رسالة مباشرة في Google Chat، مرِّر ما يلي في طلبك:

• باستخدام مصادقة التطبيق، حدِّد نطاق تفويض chat.bot. باستخدام مصادقة المستخدم، حدِّد نطاق التفويض chat.spaces.readonly أو chat.spaces.
• استدعِ طريقة FindDirectMessage()، مع تمرير name الخاص بالمستخدم الآخر في الرسالة المباشرة التي سيتم إرجاعها. باستخدام مصادقة المستخدم، تعرض هذه الطريقة رسالة مباشرة بين المستخدم الذي يجري الاتصال والمستخدم المحدّد. باستخدام مصادقة التطبيق، تعرض هذه الطريقة رسالة مباشرة بين التطبيق المتصل والمستخدم المحدّد.
• لإضافة مستخدم بشري كعضو في مساحة، حدِّد users/{user}، حيث يمثّل {user} إما {person_id} الخاص بـ person من People API، أو رقم تعريف user في Directory API. على سبيل المثال، إذا كان الشخص resourceName في People API هو people/123456789، يمكنك إضافة المستخدم إلى المساحة من خلال تضمين عضوية مع users/123456789 كـ member.name.

العثور على رسالة مباشرة تتضمّن مصادقة المستخدم

إليك كيفية العثور على رسالة مباشرة تتضمّن مصادقة المستخدم:

import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = [
  'https://www.googleapis.com/auth/chat.spaces.readonly',
];

// This sample shows how to find a Direct Message space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(
    USER_AUTH_OAUTH_SCOPES,
  );

  // Initialize request argument(s)
  const request = {
    // Replace USER_NAME here
    name: 'users/USER_NAME',
  };

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

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

await main();

لتشغيل هذا النموذج، استبدِل USER_NAME برقم التعريف من حقل name الخاص بالمستخدم.

تعرض Chat API مثيلاً من Space يوضّح تفاصيل الرسالة المباشرة المحدّدة.

العثور على رسالة مباشرة تتضمّن مصادقة التطبيق

في ما يلي كيفية العثور على رسالة مباشرة تتضمّن مصادقة التطبيق:

import {createClientWithAppCredentials} from './authentication-utils.js';

// This sample shows how to find a Direct Message space with app credential
async function main() {
  // Create a client
  const chatClient = createClientWithAppCredentials();

  // Initialize request argument(s)
  const request = {
    // Replace USER_NAME here
    name: 'users/USER_NAME',
  };

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

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

await main();

لتشغيل هذا النموذج، استبدِل USER_NAME برقم التعريف من حقل name الخاص بالمستخدم.

تعرض Chat API مثيلاً من Space يوضّح تفاصيل الرسالة المباشرة المحدّدة.

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

• إنشاء مساحة
• إعداد مساحة
• الحصول على تفاصيل حول مساحة
• مساحات القوائم
• تعديل مساحة
• حذف مساحة