একটি সরাসরি বার্তা (DM) স্থান খুঁজুন

এই নির্দেশিকায় ব্যাখ্যা করা হয়েছে কীভাবে গুগল চ্যাট এপিআই-এর Space রিসোর্সে findDirectMessage() মেথড ব্যবহার করে একটি ডিরেক্ট মেসেজ (DM) স্পেসের বিবরণ পাওয়া যায়।

Space রিসোর্স হলো এমন একটি স্থান যেখানে ব্যক্তি এবং চ্যাট অ্যাপগুলো বার্তা পাঠাতে, ফাইল শেয়ার করতে এবং একসাথে কাজ করতে পারে। বিভিন্ন ধরনের স্পেস রয়েছে:

  • ডাইরেক্ট মেসেজ (ডিএম) হলো দুইজন ব্যবহারকারীর মধ্যে অথবা একজন ব্যবহারকারী ও একটি চ্যাট অ্যাপের মধ্যে কথোপকথন।
  • গ্রুপ চ্যাট হলো তিন বা ততোধিক ব্যবহারকারীর মধ্যে চ্যাট অ্যাপের মাধ্যমে হওয়া কথোপকথন।
  • নেমড স্পেস হলো এমন স্থায়ী স্থান যেখানে মানুষ বার্তা পাঠায়, ফাইল শেয়ার করে এবং সম্মিলিতভাবে কাজ করে।

যখন কোনো গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটর তাদের সম্পূর্ণ গুগল ওয়ার্কস্পেস অর্গানাইজেশনের জন্য একটি চ্যাট অ্যাপ ইনস্টল করেন , তখন গুগল চ্যাট ইনস্টল করা চ্যাট অ্যাপ এবং অর্গানাইজেশনের প্রতিটি ব্যবহারকারীর মধ্যে একটি ডিএম (DM) তৈরি করে।

অ্যাপ অথেন্টিকেশনের মাধ্যমে প্রমাণীকরণ করলে একটি চ্যাট অ্যাপ গুগল চ্যাটে সেইসব ডিএম পেতে পারে যেগুলোতে অ্যাপটির অ্যাক্সেস আছে (উদাহরণস্বরূপ, যে ডিএমগুলোর এটি সদস্য)। ইউজার অথেন্টিকেশনের মাধ্যমে প্রমাণীকরণ করলে সেইসব ডিএম ফেরত আসে যেগুলোতে প্রমাণীকৃত ব্যবহারকারীর অ্যাক্সেস আছে।

পূর্বশর্ত

নোড.জেএস

সরাসরি বার্তা খুঁজুন

গুগল চ্যাটে সরাসরি বার্তা খুঁজে পেতে, আপনার অনুরোধে নিম্নলিখিত তথ্যগুলো দিন:

  • অ্যাপ অথেনটিকেশনের ক্ষেত্রে, chat.bot অথরাইজেশন স্কোপটি নির্দিষ্ট করুন। ইউজার অথেনটিকেশনের ক্ষেত্রে, chat.spaces.readonly অথবা chat.spaces অথরাইজেশন স্কোপটি নির্দিষ্ট করুন।
  • ফেরত দেওয়ার জন্য DM-এ থাকা অন্য ব্যবহারকারীর name পাস করে FindDirectMessage() মেথডটি কল করুন। ব্যবহারকারী প্রমাণীকরণের ক্ষেত্রে, এই মেথডটি কলকারী ব্যবহারকারী এবং নির্দিষ্ট ব্যবহারকারীর মধ্যেকার একটি DM ফেরত দেয়। অ্যাপ প্রমাণীকরণের ক্ষেত্রে, এই মেথডটি কলকারী অ্যাপ এবং নির্দিষ্ট ব্যবহারকারীর মধ্যেকার একটি DM ফেরত দেয়।
  • কোনো ব্যবহারকারীকে স্পেস সদস্য হিসেবে যুক্ত করতে, users/{user} উল্লেখ করুন, যেখানে {user} হলো People API থেকে প্রাপ্ত person {person_id} অথবা Directory API-এর কোনো user আইডি। উদাহরণস্বরূপ, যদি People API-এর ব্যক্তি resourceName হয় people/123456789 , তাহলে আপনি member.name হিসেবে users/123456789 সহ একটি মেম্বারশিপ অন্তর্ভুক্ত করে ব্যবহারকারীকে স্পেসে যুক্ত করতে পারেন।

ব্যবহারকারী প্রমাণীকরণের মাধ্যমে সরাসরি বার্তা খুঁজুন

ব্যবহারকারী প্রমাণীকরণের মাধ্যমে সরাসরি বার্তা খুঁজে বের করার উপায় নিচে দেওয়া হলো:

নোড.জেএস

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 ফিল্ড থেকে পাওয়া ID-টি বসান।

চ্যাট এপিআই Space -এর একটি ইনস্ট্যান্স ফেরত দেয়, যা নির্দিষ্ট ডিএম-টির বিবরণ প্রদান করে।

অ্যাপ প্রমাণীকরণের মাধ্যমে সরাসরি বার্তা খুঁজুন

অ্যাপ অথেন্টিকেশন ব্যবহার করে সরাসরি মেসেজ খুঁজে বের করার উপায় নিচে দেওয়া হলো:

নোড.জেএস

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 ফিল্ড থেকে পাওয়া ID-টি বসান।

চ্যাট এপিআই Space -এর একটি ইনস্ট্যান্স ফেরত দেয়, যা নির্দিষ্ট ডিএম-টির বিবরণ প্রদান করে।