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

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

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

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

عندما يثبِّت مشرف Google Workspace تطبيق Chat لمؤسسة Google Workspace بأكملها، ينشئ Google Chat رسالة مباشرة بين تطبيق 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);
}

await main();

لتشغيل هذا النموذج، استبدِل 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);
}

await main();

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

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