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

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

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

  • डायरेक्ट मैसेज (DM), दो उपयोगकर्ताओं या किसी उपयोगकर्ता और 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 है, तो 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 का एक इंस्टेंस दिखाता है, जिसमें बताए गए DM की जानकारी होती है.

ऐप्लिकेशन की पुष्टि करने के लिए भेजा गया डायरेक्ट मैसेज ढूंढना

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

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