এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে কীভাবে গুগল চ্যাট এপিআই ব্যবহার করে একটি গুগল ওয়ার্কস্পেস অর্গানাইজেশনের নির্দিষ্ট ব্যবহারকারীদের সাথে একটি গুগল চ্যাট স্পেস শেয়ার করা যায়, যাতে তারা স্পেসটি খুঁজে পেতে এবং তাতে যোগদান করতে পারে।
আপনার প্রতিষ্ঠানের কোন ব্যবহারকারীরা একটি স্পেস খুঁজে পেতে এবং তাতে যোগ দিতে পারবে, তা নির্দিষ্ট করার জন্য আপনি টার্গেট অডিয়েন্স তৈরি করেন। টার্গেট অডিয়েন্স হলো একদল লোক—যেমন নির্দিষ্ট বিভাগ বা পুরো প্রতিষ্ঠান—যাদের সাথে আপনি একটি চ্যাট স্পেস শেয়ার করতে পারেন, যাতে স্পেসটির পরিচিতি ও শেয়ারযোগ্যতা বৃদ্ধি পায়। টার্গেট অডিয়েন্স আপনাকে স্পেসের সদস্যপদ পরিচালনা এবং কাস্টমাইজ করার সুযোগও দেয়, যার ফলে আলাদা আলাদা ব্যবহারকারীকে স্পেসে আমন্ত্রণ জানানোর প্রয়োজন হয় না। আরও তথ্যের জন্য, ‘টার্গেট অডিয়েন্স সম্পর্কে’ দেখুন।
আপনি শুধুমাত্র নামযুক্ত স্পেসগুলোকেই টার্গেট অডিয়েন্সের কাছে আবিষ্কারযোগ্য করতে পারবেন। আপনি টার্গেট অডিয়েন্সের সাথে অন্য ধরনের স্পেস, যেমন ডিরেক্ট মেসেজ বা গ্রুপ কনভারসেশন, শেয়ার করতে পারবেন না।
পূর্বশর্ত
- গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি বিজনেস বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট। আপনার অ্যাকাউন্টে আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশনের জন্য সুপার অ্যাডমিনিস্ট্রেটর ভূমিকা থাকতে হবে।
- একটি টার্গেট অডিয়েন্স যা চ্যাটে অ্যাক্সেসের জন্য উপলব্ধ। একটি টার্গেট অডিয়েন্স তৈরি করতে, ‘একটি টার্গেট অডিয়েন্স তৈরি করুন’ দেখুন। একটি বিদ্যমান টার্গেট অডিয়েন্সকে চ্যাট স্পেসের জন্য উপলব্ধ করতে, ‘চ্যাটের জন্য স্পেস অ্যাক্সেস সেট আপ করুন’ দেখুন।
- আপনাকে ব্যবহারকারীর প্রমাণীকরণ সহ গুগল চ্যাট এপিআই কল করতে হবে।
লক্ষ্য দর্শকদের আইডি পান
টার্গেট অডিয়েন্সের আইডি পেতে নিম্নলিখিত পদক্ষেপগুলো অনুসরণ করুন:
গুগল অ্যাডমিন কনসোলে, > ডিরেক্টরি > টার্গেট অডিয়েন্স- এ যান।
টার্গেট অডিয়েন্স টেবিলে, টার্গেট অডিয়েন্সের নেম ফিল্ডে ক্লিক করুন।
পেজটির URL-এ টার্গেট অডিয়েন্স আইডিটি খুঁজুন। URL-এর ফরম্যাটটি হলো
https://admin.google.com/ac/targetaudiences/ TARGET_AUDIENCE_ID, যেখানেTARGET_AUDIENCE_IDহলো আপনার টার্গেট অডিয়েন্সের আলফানিউমেরিক আইডি।
পরবর্তী অংশে, আপনি টার্গেট অডিয়েন্স আইডি ব্যবহার করে একটি ডিসকভারেবল স্পেস তৈরি করতে পারেন অথবা বিদ্যমান কোনো স্পেস আপডেট করে সেটিকে টার্গেট অডিয়েন্সের কাছে ডিসকভারেবল করে তুলতে পারেন।
লক্ষ্য দর্শক এবং সুনির্দিষ্ট অনুমতি উল্লেখ করুন
নির্দিষ্ট অ্যাক্সেস অনুমতি সহ একটি স্পেস তৈরি করতে, Space রিসোর্সের উপর create বা setup মেথডটি ব্যবহার করুন। বিদ্যমান কোনো স্পেসের অনুমতি আপডেট করতে, ` update মেথডটি ব্যবহার করুন। যেহেতু শুধুমাত্র নামযুক্ত স্পেসগুলোই টার্গেট অডিয়েন্সের সাথে শেয়ার করা যায়, তাই স্পেসের ধরন (যা spaceType ফিল্ডে দেখানো থাকে) অবশ্যই SPACE হতে হবে।
কারা কোনো স্পেস আবিষ্কার করতে বা তাতে যোগদান করতে পারবে তা নির্দিষ্ট করতে, Space রিসোর্সে AccessSettings অবজেক্টটি অন্তর্ভুক্ত করুন। অবজেক্টটির মধ্যে, accessPermissionSettings ফিল্ডটি ব্যবহার করে নিম্নলিখিত এক বা একাধিক অনুমতি নির্দিষ্ট করুন:
- আবিষ্কারযোগ্য : গুগল চ্যাটের মধ্যে কারা একটি স্পেসের নাম ও বিবরণ খুঁজে পাবে এবং সেটি ব্রাউজ করতে পারবে, তা নির্ধারণ করতে
discoverSpaceSettingব্যবহার করুন। আবিষ্কারের জন্য আপনি একাধিক টার্গেট অডিয়েন্স নির্দিষ্ট করে দিতে পারেন। - যোগদানযোগ্য : কারা সুস্পষ্ট আমন্ত্রণ ছাড়াই একটি স্পেসে যোগদান করতে পারবে এবং স্পেসের বার্তাটি প্রিভিউ করতে পারবে, তা নির্ধারণ করতে
joinSpaceSettingব্যবহার করুন। যে ব্যবহারকারীরা একটি স্পেসে যোগদান করতে পারবেন, তাদের অবশ্যই সেটি খুঁজে পাওয়ারও সুযোগ থাকতে হবে। গুগল চ্যাট এই অনুমতির জন্য একটিমাত্র টার্গেট অডিয়েন্স সমর্থন করে।
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি স্পেসকে দুটি নির্দিষ্ট দর্শকগোষ্ঠীর কাছে আবিষ্কারযোগ্য এবং তাদের মধ্যে একজনের জন্য যোগদানযোগ্য করে তোলা যায়:
"accessSettings": {
"accessPermissionSettings": {
"discoverSpaceSetting": {
"principals": [
{ "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
{ "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
]
},
"joinSpaceSetting": {
"principals": [
{ "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
]
}
}
}
"টার্গেট অডিয়েন্স আইডি পান" থেকে প্রাপ্ত টার্গেট অডিয়েন্সের আইডি দিয়ে TARGET_AUDIENCE_ID_1 এবং TARGET_AUDIENCE_ID_2 প্রতিস্থাপন করুন। আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশনের জন্য ডিফল্ট চ্যাট স্পেস শেয়ার সেটিংস ব্যবহার করতে, default দিয়ে প্রতিস্থাপন করুন।
পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যের জন্য, audience ফিল্ডটি ব্যবহার করুন।
পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যতা বজায় রাখার জন্য, আপনি কোনো স্পেসে যোগ দিতে পারবে এমন একটি নির্দিষ্ট টার্গেট অডিয়েন্স নির্ধারণ করতে audience ফিল্ডটি ব্যবহার করা চালিয়ে যেতে পারেন, কিন্তু আমরা এর পরিবর্তে টার্গেট অডিয়েন্স এবং সুনির্দিষ্ট অনুমতি নির্ধারণ করার পরামর্শ দিই।
audience ফিল্ড সেট করা joinSpaceSetting এবং discoverSpaceSetting উভয় ক্ষেত্রেই টার্গেট অডিয়েন্স নির্দিষ্ট করার সমতুল্য:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
"টার্গেট অডিয়েন্স আইডি পান" থেকে প্রাপ্ত টার্গেট অডিয়েন্সের আইডি দিয়ে TARGET_AUDIENCE_ID প্রতিস্থাপন করুন। আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশনের জন্য ডিফল্ট চ্যাট স্পেস শেয়ার সেটিংস ব্যবহার করতে, default দিয়ে প্রতিস্থাপন করুন।
API প্রতিক্রিয়াগুলিতে অ্যাক্সেস সেটিংস বুঝুন
যখন আপনি স্পেস পান, তখন রেসপন্সের AccessSettings অবজেক্টটি সেই স্পেসের জন্য নির্ধারিত সূক্ষ্ম অনুমতিগুলো প্রতিফলিত করে।
AccessSettings এর নিম্নলিখিত ফিল্ডগুলি একটি স্পেসের অনুসন্ধানযোগ্যতা এবং যোগদানের অনুমতি নির্দেশ করে:
-
accessState: ডিসকভারি পারমিশন (discoverSpaceSetting) থেকে প্রাপ্ত। যদি এক বা একাধিক টার্গেট অডিয়েন্সকে ডিসকভারির অনুমতি দেওয়া হয়, তাহলে এই ফিল্ডটিDISCOVERABLEহয়। অন্যথায়, এটিPRIVATE। -
audience: বিশেষভাবে যোগদানের অনুমতির (joinSpaceSetting) সাথে সংযুক্ত। যদি কোনো একটি নির্দিষ্ট টার্গেট অডিয়েন্সকে যোগদানের অনুমতি দেওয়া হয়, তাহলে এই ফিল্ডটিতে সেই টার্গেট অডিয়েন্সের রিসোর্স নামটি থাকে।
যোগদান দর্শক ছাড়াই আবিষ্কারযোগ্য স্থান
কোনো একটি স্পেস তার নির্দিষ্ট দর্শকগোষ্ঠীর কাছে আবিষ্কারযোগ্য হতে পারে, কিন্তু সরাসরি তাতে যোগদান করা যায় না (উদাহরণস্বরূপ, যদি ব্যবহারকারীদের যোগদানের জন্য স্পষ্টভাবে আমন্ত্রণ জানাতে হয়)।
এক্ষেত্রে, AccessSettings অবজেক্টটির নিম্নলিখিত মানগুলো রয়েছে:
-
accessState:DISCOVERABLE -
audience: বাদ দেওয়া হয়েছে বাnull
যদি আপনি দেখেন accessState DISCOVERABLE হিসেবে সেট করা আছে কিন্তু audience উপস্থিত নেই, তার মানে হলো discoverSpaceSetting এ নির্দিষ্ট করা টার্গেট অডিয়েন্সরা স্পেসটি ডিসকভার করতে পারবে, কিন্তু এতে শুধুমাত্র আমন্ত্রণের মাধ্যমেই যোগদান করা যাবে। কোন কোন টার্গেট অডিয়েন্স স্পেসটি ডিসকভার করতে পারবে তা দেখতে, accessPermissionSettings.discoverSpaceSetting ফিল্ডটি দেখুন।
সম্পর্কিত বিষয়
লক্ষ্য দর্শকগোষ্ঠী সম্পর্কে বিস্তারিত জানতে নিম্নলিখিত নির্দেশিকাগুলো দেখুন:
- একটি লক্ষ্য দর্শক তৈরি করুন
- চ্যাটে শেয়ারিং সেট আপ করুন
- বিভিন্ন প্রবেশাধিকার স্তর সহ স্থান তৈরি করুন
চ্যাট এপিআই ব্যবহার করে স্পেস তৈরি বা আপডেট করার বিস্তারিত তথ্যের জন্য, নিম্নলিখিত গাইডগুলি দেখুন: