डायरेक्ट मैसेज (DM) स्पेस ढूंढना

इस गाइड में, डायरेक्ट मैसेज (डीएम) स्पेस के बारे में जानकारी पाने के लिए, Google Chat API के Space संसाधन पर findDirectMessage() तरीके का इस्तेमाल करने का तरीका बताया गया है.

Space संसाधन एक ऐसी जगह होती है जहां लोग और Chat ऐप्लिकेशन, मैसेज भेज सकते हैं, फ़ाइलें शेयर कर सकते हैं, और साथ मिलकर काम कर सकते हैं. स्पेस कई तरह के होते हैं:

  • डायरेक्ट मैसेज (डीएम), दो उपयोगकर्ताओं या किसी उपयोगकर्ता और Chat ऐप्लिकेशन के बीच की बातचीत होती है.
  • ग्रुप चैट, तीन या इससे ज़्यादा उपयोगकर्ताओं और चैट ऐप्लिकेशन के बीच होने वाली बातचीत होती है.
  • नाम वाले स्पेस, ऐसी जगहें होती हैं जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और साथ मिलकर काम करते हैं.

जब कोई Google Workspace एडमिन, अपने पूरे Google Workspace संगठन के लिए Chat ऐप्लिकेशन इंस्टॉल करता है, तो Google Chat, इंस्टॉल किए गए Chat ऐप्लिकेशन और संगठन के हर उपयोगकर्ता के बीच एक डीएम बनाता है.

ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करके पुष्टि करने पर, Chat ऐप्लिकेशन को वे डीएम मिल सकते हैं जिन्हें वह Google Chat में ऐक्सेस कर सकता है. उदाहरण के लिए, वे डीएम जिनमें वह सदस्य है. उपयोगकर्ता की पुष्टि करके पुष्टि करने पर, ऐसे डीएम दिखते हैं जिनका ऐक्सेस पुष्टि किए गए उपयोगकर्ता के पास होता है.

ज़रूरी शर्तें

Node.js

  • Business या Enterprise वर्शन वाला Google Workspace खाता, जिसमें Google Chat का ऐक्सेस हो.

कोई डायरेक्ट मैसेज ढूंढना

Google Chat में डायरेक्ट मैसेज ढूंढने के लिए, अपने अनुरोध में यह जानकारी शामिल करें:

  • ऐप्लिकेशन की पुष्टि करने की सुविधा का इस्तेमाल करके, chat.bot के लिए अनुमति का दायरा तय करें. उपयोगकर्ता की पुष्टि करने की सुविधा के साथ, chat.spaces.readonly या chat.spaces अनुमति का दायरा तय करें.
  • डीएम में मौजूद दूसरे उपयोगकर्ता के name को पास करके, FindDirectMessage() तरीके को कॉल करें. उपयोगकर्ता की पुष्टि करने के बाद, यह तरीका कॉल करने वाले उपयोगकर्ता और बताए गए उपयोगकर्ता के बीच डीएम दिखाता है. ऐप्लिकेशन की पुष्टि होने पर, यह तरीका कॉल करने वाले ऐप्लिकेशन और चुने गए उपयोगकर्ता के बीच डीएम दिखाता है.
  • किसी व्यक्ति को स्पेस के सदस्य के तौर पर जोड़ने के लिए, users/{user} तय करें. यहां {user}, People API से person का {person_id} या Directory API में user का आईडी होता है. उदाहरण के लिए, अगर People API में मौजूद व्यक्ति resourceName, people/123456789 है, तो स्पेस में उपयोगकर्ता को जोड़ा जा सकता है. इसके लिए, member.name के तौर पर users/123456789 वाली सदस्यता शामिल करें.

उपयोगकर्ता की पुष्टि करने की सुविधा के साथ डायरेक्ट मैसेज ढूंढना

उपयोगकर्ता की पुष्टि करने की सुविधा वाले डायरेक्ट मैसेज को ढूंढने का तरीका यहां बताया गया है:

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 का एक इंस्टेंस दिखाता है. इसमें बताए गए डीएम के बारे में जानकारी होती है.