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

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

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

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

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

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

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

Node.js

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

للعثور على رسالة مباشرة في 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.

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

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

Node.js

chat/client-libraries/cloud/find-dm-space-user-cred.js
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);
}

main().catch(console.error);

لتنفيذ هذا العيّنة، استبدِل USER_NAME برقم التعريف من حقل name المستخدم.

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

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

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

Node.js

chat/client-libraries/cloud/find-dm-space-app-cred.js
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);
}

main().catch(console.error);

لتنفيذ هذا العيّنة، استبدِل USER_NAME برقم التعريف من حقل name المستخدِم.

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