এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে কীভাবে গুগল চ্যাট অ্যাপগুলো গুগল চ্যাটে ইভেন্ট গ্রহণ ও সেগুলোর উত্তর দিতে পারে।
একটি গুগল চ্যাট ইভেন্ট হলো চ্যাটের কোনো কার্যকলাপ বা পরিবর্তন, যেমন কোনো স্পেসে নতুন মেসেজ আসা। আপনার চ্যাট অ্যাপ কী ঘটেছে তা বুঝতে এবং ব্যবহারকারীদের জন্য অর্থপূর্ণভাবে ব্যবস্থা নিতে বা প্রতিক্রিয়া জানাতে ইভেন্টগুলো ব্যবহার করতে পারে।
ইভেন্ট ব্যবহারের কিছু উদাহরণ নিচে দেওয়া হলো:
- কোনো একটি স্পেসে নতুন বার্তাগুলো পর্যবেক্ষণ করুন এবং সেগুলোর উত্তর দিন, যেমন—গুরুত্বপূর্ণ শব্দ বা বাক্যাংশ আছে কিনা তা পরীক্ষা করুন।
- ব্যবহারকারীরা স্পেসে যোগ দেওয়ার সাথে সাথে তাদের একটি স্বাগত বার্তা পাঠান, যেখানে স্পেসের নির্দেশিকা ব্যাখ্যা করা হবে অথবা চ্যাট অ্যাপটি কার্যকরভাবে ব্যবহার করার উপায় সম্পর্কে পরামর্শ দেওয়া হবে।
- চ্যাট কার্যকলাপ ট্র্যাক ও বিশ্লেষণ করুন। উদাহরণস্বরূপ, নতুন সদস্যদের সম্পর্কে অথবা যে বার্তাগুলিতে সর্বাধিক প্রতিক্রিয়া বা উত্তর আসে, সেগুলির বিষয়ে মাসিক প্রতিবেদন পাঠানোর জন্য।
- বিভিন্ন মেসেজিং প্ল্যাটফর্মে যোগাযোগ করুন। উদাহরণস্বরূপ, ব্যবহারকারীরা চ্যাট থেকে বের না হয়েই অন্য কোনো মেসেজিং প্ল্যাটফর্মের ব্যবহারকারীদের কাছে বার্তা পাঠাতে ও গ্রহণ করতে পারেন।
ইভেন্টগুলো কীভাবে কাজ করে
গুগল চ্যাটে যখনই কোনো ঘটনা ঘটে, তখন একটি গুগল চ্যাট এপিআই রিসোর্স তৈরি, আপডেট বা ডিলিট করা হয়। কী ধরনের কার্যকলাপ ঘটেছে এবং কোন চ্যাট এপিআই রিসোর্সটি প্রভাবিত হয়েছে, সে সম্পর্কে আপনার চ্যাট অ্যাপে তথ্য পৌঁছে দিতে চ্যাট ইভেন্ট ব্যবহার করে।
Message রিসোর্স তৈরি করে। এরপর চ্যাট একটি ইভেন্ট তৈরি করে, যাতে নতুন বার্তাটি সম্পর্কিত তথ্য থাকে।চ্যাট ইভেন্টগুলোকে ধরন অনুযায়ী শ্রেণীবদ্ধ করে। ইভেন্টের ধরনগুলো আপনাকে শুধুমাত্র প্রয়োজনীয় তথ্য ফিল্টার করে গ্রহণ করতে সাহায্য করে এবং একই ধরনের কার্যকলাপগুলোকে একইভাবে পরিচালনা করার সুযোগ দেয়।
নিম্নলিখিত সারণিতে দেখানো হয়েছে যে, চ্যাটের কোনো কার্যকলাপ কীভাবে একটি সম্পর্কিত চ্যাট এপিআই রিসোর্সকে প্রভাবিত করে এবং আপনার চ্যাট অ্যাপটি কোন ধরনের ইভেন্ট গ্রহণ করে:
| কার্যকলাপ | চ্যাট এপিআই রিসোর্স | ইভেন্টের ধরণ |
|---|---|---|
| একজন ব্যবহারকারী চ্যাট স্পেসে একটি বার্তা পোস্ট করেন। | একটি Message রিসোর্স তৈরি করা হয়েছে। | নতুন বার্তা |
| একজন ব্যবহারকারী স্পেস ম্যানেজার হন। | Membership সংক্রান্ত একটি রিসোর্স আপডেট করা হয়েছে। | হালনাগাদকৃত সদস্যপদ |
| একজন ব্যবহারকারী একটি বার্তার প্রতি প্রতিক্রিয়া জানান। | একটি Reaction রিসোর্স তৈরি করা হয়। | নতুন প্রতিক্রিয়া |
| একজন ব্যবহারকারী একটি স্থান খালি রাখেন। | Membership একটি রিসোর্স মুছে ফেলা হয়েছে। | মুছে ফেলা সদস্যপদ |
গুগল চ্যাট থেকে ইভেন্ট গ্রহণ করুন
ইভেন্ট গ্রহণ করার জন্য, আপনার চ্যাট অ্যাপ নিম্নলিখিত দুটি পদ্ধতির যেকোনো একটি অনুসরণ করতে পারে:
- ইভেন্ট ঘটার সাথে সাথে তা পাওয়ার জন্য গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই (Google Workspace Events API) ব্যবহার করে সাবস্ক্রাইব করুন।
- চ্যাট এপিআই কল করে সাম্প্রতিক ঘটনাবলী সম্পর্কে জানুন।
নিম্নলিখিত সারণিতে ইভেন্ট কোয়েরি করা বা সাবস্ক্রাইব করার পার্থক্য এবং কারণ ব্যাখ্যা করা হয়েছে:
| ইভেন্টগুলিতে সাবস্ক্রাইব করুন | ইভেন্টগুলির জন্য অনুসন্ধান করুন | |
|---|---|---|
| ব্যবহারের ক্ষেত্র |
|
|
| এপিআই | গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই | চ্যাট এপিআই |
| ঘটনাগুলির উৎস | স্পেস, ব্যবহারকারী এবং গুগল ওয়ার্কস্পেস অর্গানাইজেশন ( ডেভেলপার প্রিভিউ) | শুধুমাত্র স্থান |
| সমর্থিত ইভেন্টগুলি |
সমর্থিত ইভেন্টের প্রকারগুলির তালিকার জন্য, Google Workspace Events API ডকুমেন্টেশনে ‘সাবস্ক্রিপশন তৈরির জন্য ইভেন্টের প্রকার’ দেখুন। |
সমর্থিত ইভেন্টের প্রকারভেদের তালিকার জন্য, চ্যাট এপিআই রেফারেন্স ডকুমেন্টেশনে থাকা spaceEvents রিসোর্সটি দেখুন। |
| ইভেন্টের বিন্যাস | একটি গুগল ক্লাউড পাব/সাব বার্তা, যা ক্লাউডইভেন্ট স্পেসিফিকেশন অনুযায়ী ফরম্যাট করা হয়েছে। বিস্তারিত জানতে, গুগল ওয়ার্কস্পেস ইভেন্টের কাঠামো দেখুন। | একটি চ্যাট এপিআই রিসোর্স ( spaces.spaceEvent ) |
| ইভেন্টের ডেটা | রিসোর্স ডেটা সহ বা ছাড়া Base64-এনকোডেড স্ট্রিং। উদাহরণ পেলোডের জন্য, ইভেন্ট ডেটা দেখুন। | JSON পেলোড যাতে রিসোর্স ডেটা থাকে। কিছু ইভেন্ট টাইপে শুধুমাত্র নির্দিষ্ট রিসোর্স ফিল্ড অন্তর্ভুক্ত থাকে। উদাহরণ পেলোডের জন্য, রেফারেন্স ডকুমেন্টেশন দেখুন। |
উদাহরণ: কোনো স্পেসের সদস্যপদ সম্পর্কিত ইভেন্টগুলো সম্পর্কে জিজ্ঞাসা করুন বা সাবস্ক্রাইব করুন।
এই উদাহরণে, একটি চ্যাট অ্যাপ একটি চ্যাট স্পেসের সদস্যদের পরিবর্তনের তথ্য পেতে চায়। স্পেসটিতে নিম্নলিখিত সদস্যপদ কার্যকলাপ ঘটে থাকে:
- একজন ব্যবহারকারী স্পেসটিতে যোগদান করেন, যা একটি
Membershipরিসোর্স তৈরি করে এবং একটি নতুন সদস্য ইভেন্ট ট্রিগার করে। - একজন ব্যবহারকারী স্পেস ম্যানেজার হন, যা তার জন্য
Membershipরিসোর্স আপডেট করে এবং একটি আপডেটেড মেম্বার ইভেন্ট ট্রিগার করে। - একজন ব্যবহারকারী স্পেসটি ত্যাগ করলে, তার জন্য
Membershipরিসোর্সটি মুছে যায় এবং একটি মেম্বার ডিলিটেড ইভেন্ট ট্রিগার হয়।
সদস্যপদ ইভেন্টগুলিতে সাবস্ক্রাইব করুন
রিয়েল টাইমে ইভেন্ট গ্রহণ করার জন্য, চ্যাট অ্যাপটি সব ধরনের মেম্বারশিপ ইভেন্টের জন্য স্পেসটিতে সাবস্ক্রাইব করতে Google Workspace Events API-এর subscriptions.create() মেথডকে কল করে। সাবস্ক্রিপশন তৈরি করার পর, চ্যাট অ্যাপটি মেম্বারশিপ ইভেন্ট গ্রহণ করা শুরু করতে পারে।
চিত্র ২-এ, চ্যাট অ্যাপটির স্পেসটিতে একটি সক্রিয় সাবস্ক্রিপশন রয়েছে, তাই স্পেসটির কোনো সদস্যপদ পরিবর্তিত হলেই অ্যাপটি একটি ইভেন্ট পায়। এরপর চ্যাট অ্যাপটি সেই কার্যকলাপগুলোর যেকোনো একটিকে রিয়েল টাইমে প্রক্রিয়া করতে বা তার প্রতিক্রিয়া জানাতে পারে, যেমন স্পেসটিতে যোগদানকারী সদস্যকে একটি ব্যক্তিগত স্বাগত বার্তা পোস্ট করা।
Google Workspace Events API ব্যবহার করে সাবস্ক্রিপশন তৈরি করার বিষয়ে জানতে, Google Workspace Events API ডকুমেন্টেশন দেখুন।
সাম্প্রতিক সদস্যপদ ইভেন্টগুলির জন্য অনুসন্ধান করুন
সদস্যপদ সংক্রান্ত ইভেন্টগুলো ঘটার সাথে সাথে গ্রহণ করার পরিবর্তে, একটি চ্যাট অ্যাপ চ্যাট এপিআই-কে কল করে সদস্যপদ কার্যকলাপের সাথে সম্পর্কিত সাম্প্রতিক স্পেস ইভেন্টগুলোর তালিকা পেতে পারে।
চিত্র ৩-এ, একটি চ্যাট অ্যাপ সমস্ত সদস্যপদ কার্যকলাপ সম্পন্ন হওয়ার পরে চ্যাট এপিআই-এর spaces.spaceEvents.list() মেথডটি কল করে এবং নতুন, আপডেট করা ও মুছে ফেলা সদস্যপদ ইভেন্টগুলোর জন্য কোয়েরিটি ফিল্টার করে। চ্যাট এপিআই প্রতিটি সদস্যপদ পরিবর্তনকে প্রতিনিধিত্বকারী spaceEvent রিসোর্সের একটি তালিকা ফেরত দেয়। এরপর চ্যাট অ্যাপটি সাম্প্রতিক কার্যকলাপের উপর ভিত্তি করে ব্যবস্থা নিতে বা প্রতিক্রিয়া জানাতে পারে, যেমন গত ৭ দিনে স্পেসটির সদস্যপদ কার্যকলাপের সারসংক্ষেপসহ একটি সাপ্তাহিক বার্তা পোস্ট করা।
চ্যাট এপিআই ব্যবহার করে ইভেন্ট অনুসন্ধান করতে, “একটি গুগল চ্যাট স্পেস থেকে ইভেন্ট তালিকাভুক্ত করুন” দেখুন।
সীমাবদ্ধতা এবং বিতরণ আচরণ
সাধারণ সীমাবদ্ধতা
- মেম্বারশিপ ইভেন্ট পেতে হলে, ব্যবহারকারী বা চ্যাট অ্যাপটিকে অবশ্যই স্পেসটির সরাসরি সদস্য হতে হবে। যদি তাদের কোনো গুগল গ্রুপের মাধ্যমে পরোক্ষভাবে কোনো স্পেসে যুক্ত, আপডেট বা অপসারণ করা হয়, তাহলে সাবস্ক্রিপশনটি সেই মেম্বারশিপ ইভেন্টগুলো পাবে না। গুগল গ্রুপ মেম্বারশিপ কীভাবে কাজ করে তা বুঝতে, ‘একটি স্পেসে গুগল গ্রুপ যুক্ত করুন’ দেখুন।
ব্যবহারকারীর সাবস্ক্রিপশন
- ব্যবহারকারীদের সাবস্ক্রিপশনের ক্ষেত্রে, ডাইরেক্ট মেসেজ বা নামবিহীন গ্রুপ চ্যাটে (
google.workspace.chat.membership.v1.created) নতুন সদস্যদের সম্পর্কিত ইভেন্টগুলো শুধুমাত্র প্রথম মেসেজ পোস্ট করার পরেই ট্রিগার হয়।
গ্রাহক সাবস্ক্রিপশন ( ডেভেলপার প্রিভিউ)
গ্রাহক সাবস্ক্রিপশনের ক্ষেত্রে নিম্নলিখিত সীমাবদ্ধতাগুলো প্রযোজ্য:
- Google Workspace অর্গানাইজেশনে অবশ্যই অন্তত একটি এন্টারপ্রাইজ SKU লাইসেন্স থাকতে হবে। উল্লেখ্য যে, ডেভেলপার প্রিভিউ প্রোগ্রাম পর্যায়ে এই শর্তটি কঠোরভাবে প্রয়োগ করা হয় না, তবে ভবিষ্যতে এটি কার্যকর করা হবে (যা আলাদাভাবে ঘোষণা করা হবে)।
- একটি চ্যাট অ্যাপ একটি নির্দিষ্ট গুগল ওয়ার্কস্পেস অর্গানাইজেশনের জন্য শুধুমাত্র একটি কাস্টমার সাবস্ক্রিপশন তৈরি করতে পারে। একটি গুগল ওয়ার্কস্পেস অর্গানাইজেশনে মোট সর্বোচ্চ পাঁচটি কাস্টমার সাবস্ক্রিপশন থাকতে পারে (যা বিভিন্ন চ্যাট অ্যাপ দ্বারা তৈরি)।
গ্রাহক সাবস্ক্রিপশনের ক্ষেত্রে, ইভেন্ট ডেলিভারি নিম্নলিখিত সাধারণ নিয়মগুলি অনুসরণ করে:
- স্পেস ইভেন্ট : শুধুমাত্র তখনই ডেলিভার করা হবে, যদি ইভেন্টটি আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশন দ্বারা পরিচালিত কোনো স্পেসে সংঘটিত হয়।
- ব্যবহারকারী ইভেন্ট : শুধুমাত্র তখনই ডেলিভার করা হবে, যখন ইভেন্টটি আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশনের অন্তর্ভুক্ত কোনো ব্যবহারকারীর জন্য ঘটে।
এই নিয়মগুলির একমাত্র ব্যতিক্রম হলো মেম্বারশিপ ইভেন্ট । আপনার সাবস্ক্রিপশন আপনার সংস্থা দ্বারা পরিচালিত স্থান এবং বাহ্যিক সংস্থা দ্বারা পরিচালিত স্থান উভয় থেকেই মেম্বারশিপ ইভেন্ট গ্রহণ করতে পারে, কিন্তু সেগুলি কীভাবে সরবরাহ করা হবে তা নির্ভর করে কোন সংস্থা স্থানটি পরিচালনা করে তার উপর:
আপনার গুগল ওয়ার্কস্পেস সংস্থা দ্বারা পরিচালিত স্পেসগুলি
গুগল ওয়ার্কস্পেস সংস্থা দ্বারা পরিচালিত কোনো স্পেসে সদস্যপদ পরিবর্তন হলে, তা একটি স্পেস ইভেন্ট হিসেবে পাঠানো হয়।
একটি স্পেস ইভেন্টের রিসোর্স নামটি নিম্নলিখিত বিন্যাস ব্যবহার করে:
spaces/{spaceId}/spaceEvents/{spaceEventId}
বাহ্যিক সংস্থা দ্বারা পরিচালিত স্থান
আপনার Google Workspace অর্গানাইজেশন দ্বারা পরিচালিত কোনো ব্যবহারকারীর সদস্যপদ যদি কোনো বাহ্যিক অর্গানাইজেশন দ্বারা পরিচালিত স্পেসে (যেমন, একটি বাহ্যিক নেমড স্পেস বা কোনো বাহ্যিক ব্যবহারকারীর তৈরি করা ডিরেক্ট মেসেজ) পরিবর্তিত হয়, তাহলে আপনার সাবস্ক্রিপশন এই ইভেন্টটিকে একটি ইউজার ইভেন্ট হিসেবে গ্রহণ করে।
ব্যবহারকারী ইভেন্টের রিসোর্স নামটি নিম্নলিখিত বিন্যাস ব্যবহার করে:
users/{userId}/userEvents/{userEventId}
সম্পর্কিত বিষয়
- গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই-এর সংক্ষিপ্ত বিবরণ
- একটি সাবস্ক্রিপশন তৈরি করুন
- গুগল চ্যাট স্পেসের একটি ইভেন্ট সম্পর্কে বিস্তারিত জানুন।
- গুগল চ্যাট স্পেস থেকে ইভেন্টগুলির তালিকা