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

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

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

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

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

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

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

Node.js

  • आपके पास Google Workspace का Business या Enterprise वर्शन वाला खाता हो. साथ ही, आपके पास Google Chat का ऐक्सेस हो.

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

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

  • ऐप्लिकेशन की पुष्टि के लिए, chat.bot अनुमति का दायरा तय करें. उपयोगकर्ता की पुष्टि के लिए, अनुमति के chat.spaces.readonly या chat.spaces दायरे की जानकारी दें.
  • FindDirectMessage(), तरीका कॉल करें और डीएम में मौजूद दूसरे उपयोगकर्ता का name पास करें. उपयोगकर्ता की पुष्टि करने पर, यह तरीका कॉल करने वाले उपयोगकर्ता और चुने गए उपयोगकर्ता के बीच डीएम भेजता है. ऐप्लिकेशन की पुष्टि करने के बाद, यह तरीका कॉल करने वाले ऐप्लिकेशन और चुने गए उपयोगकर्ता के बीच डीएम भेजता है.
  • किसी व्यक्ति को स्पेस के सदस्य के तौर पर जोड़ने के लिए, 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);
}

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