Google Workspace সংস্থার নির্দিষ্ট ব্যবহারকারীদের জন্য Google Chat স্পেস আবিষ্কারযোগ্য করুন

এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে কীভাবে গুগল চ্যাট এপিআই ব্যবহার করে একটি গুগল ওয়ার্কস্পেস অর্গানাইজেশনের নির্দিষ্ট ব্যবহারকারীদের সাথে একটি গুগল চ্যাট স্পেস শেয়ার করা যায়, যাতে তারা সেই স্পেসের সদস্যদের খুঁজে বের করতে, যোগদান করতে এবং দেখতে পারেন।

আপনার প্রতিষ্ঠানের কোন ব্যবহারকারীরা কোনো স্পেসের সদস্যদের খুঁজে পেতে, যোগদান করতে এবং দেখতে পারবে, তা নির্দিষ্ট করার জন্য আপনি টার্গেট অডিয়েন্স তৈরি করেন। টার্গেট অডিয়েন্স হলো একদল লোক—যেমন নির্দিষ্ট বিভাগ বা পুরো প্রতিষ্ঠান—যাদের সাথে আপনি একটি চ্যাট স্পেস শেয়ার করতে পারেন, যাতে কারা স্পেসটি এবং এর তথ্য অ্যাক্সেস করতে পারবে তার উপর আরও সূক্ষ্ম নিয়ন্ত্রণ রাখা যায়। টার্গেট অডিয়েন্স আপনাকে স্পেসের সদস্যপদ পরিচালনা এবং কাস্টমাইজ করার সুযোগও দেয়, যার ফলে আলাদা আলাদা ব্যবহারকারীকে স্পেসে আমন্ত্রণ জানানোর প্রয়োজন হয় না। আরও তথ্যের জন্য, ‘টার্গেট অডিয়েন্স সম্পর্কে’ দেখুন।

আপনি শুধুমাত্র নামযুক্ত স্পেসগুলোকেই টার্গেট অডিয়েন্সের কাছে আবিষ্কারযোগ্য করতে পারবেন। আপনি টার্গেট অডিয়েন্সের সাথে অন্য ধরনের স্পেস, যেমন ডিরেক্ট মেসেজ বা গ্রুপ কনভারসেশন, শেয়ার করতে পারবেন না।

পূর্বশর্ত

• গুগল চ্যাট ব্যবহারের সুবিধাসহ একটি বিজনেস বা এন্টারপ্রাইজ গুগল ওয়ার্কস্পেস অ্যাকাউন্ট। আপনার অ্যাকাউন্টে আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশনের জন্য সুপার অ্যাডমিনিস্ট্রেটর ভূমিকা থাকতে হবে।
• একটি টার্গেট অডিয়েন্স যা চ্যাটে অ্যাক্সেসের জন্য উপলব্ধ। একটি টার্গেট অডিয়েন্স তৈরি করতে, ‘একটি টার্গেট অডিয়েন্স তৈরি করুন’ দেখুন। একটি বিদ্যমান টার্গেট অডিয়েন্সকে চ্যাট স্পেসের জন্য উপলব্ধ করতে, ‘চ্যাটের জন্য স্পেস অ্যাক্সেস সেট আপ করুন’ দেখুন।
• আপনাকে ব্যবহারকারীর প্রমাণীকরণ সহ গুগল চ্যাট এপিআই কল করতে হবে।

টার্গেট অডিয়েন্স আইডি সংগ্রহ করুন

টার্গেট অডিয়েন্সের আইডি পেতে নিম্নলিখিত পদক্ষেপগুলো অনুসরণ করুন:

1. গুগল অ্যাডমিন কনসোলে, > ডিরেক্টরি > টার্গেট অডিয়েন্স- এ যান।

   লক্ষ্য দর্শকদের কাছে যান

2. টার্গেট অডিয়েন্স টেবিলে, টার্গেট অডিয়েন্সের নেম ফিল্ডে ক্লিক করুন।

3. পেজটির 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 ব্যবহার করুন। যে ব্যবহারকারীরা একটি স্পেসে যোগদান করতে পারবেন, তাদের অবশ্যই সেটি খুঁজে পাওয়ারও সুযোগ থাকতে হবে। গুগল চ্যাট এই অনুমতির জন্য একটিমাত্র টার্গেট অডিয়েন্স সমর্থন করে।
• সদস্যপদ দেখা : একটি স্পেসের সদস্যদের তালিকা কারা দেখতে পারবে তা নির্ধারণ করতে viewSpaceMembershipSetting ব্যবহার করুন। স্পেসের সদস্যপদ কারা দেখতে পারবে তা আপডেট করার সময়, updateMask এবং request body উভয় স্থানেই accessSettings.accessPermissionSettings.viewSpaceMembershipSetting এবং permissionSettings.viewSpaceMembership একসাথে উল্লেখ করতে হবে। যখন viewSpaceMembershipSetting এ একটি টার্গেট অডিয়েন্স কনফিগার করা হয়, তখন সকল সদস্যকে viewSpaceMembership প্রদান করতে হবে ( managersAllowed , assistantManagersAllowed , এবং membersAllowed true সেট করে)।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি স্পেসকে দুটি নির্দিষ্ট টার্গেট অডিয়েন্সের কাছে আবিষ্কারযোগ্য করা যায়, তাদের মধ্যে একজনের জন্য এতে যোগদানযোগ্য করা যায়, এবং একই সাথে এটি নিশ্চিত করা যায় যে সকল সদস্য ও নির্দিষ্ট টার্গেট অডিয়েন্স সদস্যরা তালিকাটি দেখতে পারবে:

{
  "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" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

"টার্গেট অডিয়েন্স আইডি পান" থেকে প্রাপ্ত টার্গেট অডিয়েন্সের আইডি দিয়ে TARGET_AUDIENCE_ID_1 এবং TARGET_AUDIENCE_ID_2 প্রতিস্থাপন করুন। আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশনের জন্য ডিফল্ট চ্যাট স্পেস শেয়ার সেটিংস ব্যবহার করতে, default দিয়ে প্রতিস্থাপন করুন।

পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যের জন্য, audience ফিল্ডটি ব্যবহার করুন।

পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যতা বজায় রাখার জন্য, আপনি কোনো স্পেসে যোগ দিতে পারবে এমন একটি নির্দিষ্ট টার্গেট অডিয়েন্স নির্ধারণ করতে audience ফিল্ডটি ব্যবহার করা চালিয়ে যেতে পারেন, কিন্তু আমরা এর পরিবর্তে টার্গেট অডিয়েন্স এবং সুনির্দিষ্ট অনুমতি নির্ধারণ করার পরামর্শ দিই।

audience ফিল্ড সেট করা joinSpaceSetting এ টার্গেট অডিয়েন্স নির্দিষ্ট করার সমতুল্য:

  "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 ফিল্ডটি দেখুন।

সম্পর্কিত বিষয়

লক্ষ্য দর্শকগোষ্ঠী সম্পর্কে বিস্তারিত জানতে নিম্নলিখিত নির্দেশিকাগুলো দেখুন:

• একটি লক্ষ্য দর্শক তৈরি করুন
• চ্যাটে শেয়ারিং সেট আপ করুন
• বিভিন্ন প্রবেশাধিকার স্তর সহ স্থান তৈরি করুন

চ্যাট এপিআই ব্যবহার করে স্পেস তৈরি বা আপডেট করার বিস্তারিত তথ্যের জন্য, নিম্নলিখিত গাইডগুলি দেখুন:

• একটি জায়গা তৈরি করুন
• একটি জায়গা তৈরি করুন
• একটি স্থান আপডেট করুন