Google Chat থেকে ইভেন্ট নিয়ে কাজ করুন

এই পৃষ্ঠাটি ব্যাখ্যা করে যে কীভাবে Google Chat অ্যাপগুলি Google Chat-এ ইভেন্টগুলি গ্রহণ করতে এবং প্রতিক্রিয়া জানাতে পারে।

একটি Google চ্যাট ইভেন্ট চ্যাটে একটি কার্যকলাপ বা পরিবর্তনের প্রতিনিধিত্ব করে, যেমন একটি স্পেসে একটি নতুন বার্তা। আপনার চ্যাট অ্যাপ ইভেন্টগুলি ব্যবহার করে কী ঘটেছে তা বুঝতে এবং পদক্ষেপ নিতে বা আপনার ব্যবহারকারীদের জন্য অর্থপূর্ণ উপায়ে প্রতিক্রিয়া জানাতে পারে।

আপনি কীভাবে ইভেন্টগুলি ব্যবহার করতে পারেন তার কিছু উদাহরণ এখানে দেওয়া হল:

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

ঘটনা কিভাবে কাজ করে

যখনই Google Chat-এ কিছু ঘটে, একটি Google Chat API রিসোর্স তৈরি, আপডেট করা বা মুছে ফেলা হয়। চ্যাট ইভেন্ট ব্যবহার করে আপনার চ্যাট অ্যাপে যে ধরনের অ্যাক্টিভিটি ঘটেছে এবং যে চ্যাট এপিআই রিসোর্স প্রভাবিত হয়েছে সে সম্পর্কে তথ্য সরবরাহ করে।

Google চ্যাট স্পেসে পোস্ট করা একটি বার্তা কীভাবে একটি ইভেন্টকে ট্রিগার করে তার উদাহরণ।
চিত্র 1. একজন ব্যবহারকারী একটি চ্যাট স্পেসে একটি বার্তা পোস্ট করে, যা একটি Message সংস্থান তৈরি করে। চ্যাট তারপর একটি ইভেন্ট তৈরি করে যাতে নতুন বার্তা সম্পর্কে ডেটা থাকে।

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

নিম্নলিখিত সারণীটি দেখায় যে কীভাবে চ্যাটে একটি অ্যাক্টিভিটি একটি সম্পর্কিত চ্যাট API সংস্থানকে প্রভাবিত করে এবং আপনার চ্যাট অ্যাপটি যে ধরনের ইভেন্ট গ্রহণ করে:

কার্যকলাপ চ্যাট API সংস্থান ইভেন্টের ধরণ
একজন ব্যবহারকারী চ্যাট স্পেসে একটি বার্তা পোস্ট করেন একটি Message সংস্থান তৈরি করা হয়। নতুন বার্তা
একজন ব্যবহারকারী স্পেস ম্যানেজার হয়ে যায়। একটি Membership সম্পদ আপডেট করা হয়. আপডেট করা সদস্যপদ
একটি ব্যবহারকারী একটি বার্তা প্রতিক্রিয়া. একটি Reaction সংস্থান তৈরি করা হয়। নতুন প্রতিক্রিয়া
একজন ব্যবহারকারী একটি স্থান ছেড়ে যায়। একটি Membership সম্পদ মুছে ফেলা হয়েছে. সদস্যপদ মুছে ফেলা হয়েছে

Google চ্যাট থেকে ইভেন্টগুলি পান৷

ইভেন্টগুলি পেতে, আপনার চ্যাট অ্যাপ নিম্নলিখিতগুলির যেকোনো একটি করতে পারে:

  • Google Workspace Events API ব্যবহার করে ইভেন্টের সদস্যতা নিন যাতে ইভেন্টগুলি ঘটে।
  • চ্যাট এপিআই কল করে সাম্প্রতিক ইভেন্টের জন্য ক্যোয়ারী।

নিম্নলিখিত টেবিলটি ইভেন্টগুলিতে অনুসন্ধান বা সদস্যতা নেওয়ার পার্থক্য এবং কারণগুলি ব্যাখ্যা করে:

ইভেন্ট সদস্যতা ইভেন্টের জন্য ক্যোয়ারী
ব্যবহারের ক্ষেত্রে
  • রিয়েল টাইমে ইভেন্টগুলি প্রক্রিয়া করুন বা সাড়া দিন।
  • ব্যবহারকারীদের সদস্যতা কার্যকলাপ নিরীক্ষণ এবং নিরীক্ষণের জন্য নতুন স্থান আবিষ্কার করুন.
  • পর্যায়ক্রমে বা ট্রিগারের মাধ্যমে ইভেন্টগুলি প্রক্রিয়া করুন বা সাড়া দিন।
  • সাবস্ক্রিপশন থেকে মিস করা ইভেন্টগুলি আনুন (একটি বিভ্রাট বা নিষ্ক্রিয় সাবস্ক্রিপশনের কারণে)।
API Google Workspace ইভেন্ট API চ্যাট API
ঘটনার উৎস স্থান এবং ব্যবহারকারী শুধুমাত্র স্থান
সমর্থিত ঘটনা
  • বার্তা
  • সদস্যপদ
  • প্রতিক্রিয়া
  • স্থান

সমর্থিত ইভেন্ট প্রকারের তালিকার জন্য, Google Workspace Events API ডকুমেন্টেশনে সদস্যতা তৈরির জন্য ইভেন্টের ধরন দেখুন।
  • বার্তা
  • সদস্যপদ
  • প্রতিক্রিয়া
  • স্থান

সমর্থিত ইভেন্ট প্রকারের তালিকার জন্য, চ্যাট এপিআই রেফারেন্স ডকুমেন্টেশনে spaceEvents রিসোর্স দেখুন।
ইভেন্ট বিন্যাস একটি Google ক্লাউড পাব/সাব বার্তা, ক্লাউড ইভেন্ট স্পেসিফিকেশন অনুযায়ী ফর্ম্যাট করা হয়েছে। বিস্তারিত জানতে, Google Workspace ইভেন্টের কাঠামো দেখুন। একটি চ্যাট API সংস্থান ( spaces.spaceEvent )
ইভেন্ট ডেটা বেস64-এনকোডেড স্ট্রিং রিসোর্স ডেটা সহ বা ছাড়া। উদাহরণস্বরূপ পেলোড, ইভেন্ট ডেটা দেখুন। JSON পেলোড যাতে রিসোর্স ডেটা থাকে। কিছু ইভেন্টের ধরন শুধুমাত্র নির্দিষ্ট রিসোর্স ক্ষেত্র অন্তর্ভুক্ত করে। উদাহরণ পেলোডের জন্য, রেফারেন্স ডকুমেন্টেশন দেখুন।

উদাহরণ: একটি স্পেসে সদস্যতা সম্পর্কে ইভেন্টগুলি জিজ্ঞাসা করুন বা সদস্যতা নিন৷

এই উদাহরণে, একটি চ্যাট অ্যাপ একটি চ্যাট স্পেসের সদস্যদের পরিবর্তন সম্পর্কে তথ্য পেতে চায়। স্পেসে, নিম্নলিখিত সদস্যপদ কার্যকলাপ ঘটে:

  • একজন ব্যবহারকারী স্পেসে যোগদান করে, যা একটি Membership সংস্থান তৈরি করে এবং একটি নতুন সদস্য ইভেন্ট ট্রিগার করে।
  • একজন ব্যবহারকারী একজন স্পেস ম্যানেজার হয়ে ওঠে, যা ব্যবহারকারীর জন্য Membership সংস্থান আপডেট করে এবং একটি আপডেট হওয়া সদস্য ইভেন্টকে ট্রিগার করে।
  • একজন ব্যবহারকারী স্থানটি ছেড়ে যায়, যা ব্যবহারকারীর জন্য Membership সংস্থান মুছে ফেলে এবং একটি সদস্য মুছে ফেলা ইভেন্টকে ট্রিগার করে।

সদস্যতা ইভেন্ট সদস্যতা

রিয়েল টাইমে ইভেন্টগুলি পেতে, Chat অ্যাপটি Google Workspace Events API subscriptions.create() পদ্ধতিতে কল করে যাতে সব ধরনের মেম্বারশিপ ইভেন্টের জন্য স্পেস সাবস্ক্রাইব করা হয়। সদস্যতা তৈরি করার পরে, চ্যাট অ্যাপ সদস্যতা ইভেন্টগুলি পেতে শুরু করতে পারে।

Chat অ্যাপ যেটি Google Workspace Events API ব্যবহার করে ইভেন্টে সদস্যতা নেয়।
চিত্র 2. Google Workspace Events API ব্যবহার করে একটি Chat অ্যাপ সদস্যতা ইভেন্ট গ্রহণ করে।

চিত্র 2-এ, চ্যাট অ্যাপের স্পেসের একটি সক্রিয় সদস্যতা রয়েছে, তাই যখনই স্পেসে সদস্যপদ পরিবর্তন হয় তখন অ্যাপটি একটি ইভেন্ট গ্রহণ করে। চ্যাট অ্যাপটি তারপরে যে কোনও ক্রিয়াকলাপে রিয়েল টাইমে প্রক্রিয়া করতে পারে বা প্রতিক্রিয়া জানাতে পারে, যেমন স্পেসে যোগদানকারী সদস্যকে একটি ব্যক্তিগত স্বাগত বার্তা পোস্ট করা।

Google Workspace Events API ব্যবহার করে সাবস্ক্রিপশন তৈরি করার বিষয়ে জানতে, Google Workspace Events API ডকুমেন্টেশন দেখুন।

সাম্প্রতিক সদস্যপদ ইভেন্টের জন্য ক্যোয়ারী

মেম্বারশিপ ইভেন্টগুলি হওয়ার পরিবর্তে, একটি চ্যাট অ্যাপ মেম্বারশিপ অ্যাক্টিভিটি সম্পর্কিত সাম্প্রতিক স্পেস ইভেন্টগুলি তালিকাভুক্ত করতে Chat API-কে কল করতে পারে।

চ্যাট অ্যাপ যা চ্যাট এপিআই ব্যবহার করে ইভেন্টের জন্য প্রশ্ন করে।
চিত্র 3. একটি চ্যাট অ্যাপ চ্যাট API ব্যবহার করে স্পেস ইভেন্টগুলির জন্য অনুসন্ধান করে সাম্প্রতিক সদস্যপদ ইভেন্টগুলি গ্রহণ করে৷

চিত্র 3-এ, একটি চ্যাট অ্যাপ Chat API spaces.spaceEvents.list() মেথডকে কল করে মেম্বারশিপ ক্রিয়াকলাপ শেষ হওয়ার পরে এবং নতুন, আপডেট করা এবং মুছে ফেলা সদস্যতা ইভেন্টগুলির জন্য ক্যোয়ারী ফিল্টার করে। চ্যাট এপিআই spaceEvent সংস্থানগুলির একটি তালিকা প্রদান করে যা সদস্যপদ পরিবর্তনের প্রতিটি প্রতিনিধিত্ব করে। চ্যাট অ্যাপটি সাম্প্রতিক কার্যকলাপের উপর ভিত্তি করে প্রক্রিয়া করতে বা প্রতিক্রিয়া জানাতে পারে, যেমন গত 7 দিনের মধ্যে স্পেসের সদস্যতা কার্যকলাপের সারাংশ সহ একটি সাপ্তাহিক বার্তা পোস্ট করা।

চ্যাট এপিআই ব্যবহার করে ইভেন্টের জন্য অনুসন্ধান করতে, একটি Google চ্যাট স্থান থেকে ইভেন্টের তালিকা দেখুন।

সীমাবদ্ধতা

  • ব্যবহারকারীদের সাবস্ক্রিপশনের জন্য, সরাসরি বার্তা বা নামহীন গ্রুপ চ্যাটে নতুন সদস্যদের সম্পর্কে ইভেন্টগুলি ( google.workspace.chat.membership.v1.created ), শুধুমাত্র প্রথম বার্তা পোস্ট করার পরেই ট্রিগার হয়৷
  • স্থান ইতিহাসের পরিবর্তনগুলি আপডেট করা স্থান ইভেন্টগুলিকে ট্রিগার করে না (ইভেন্টের ধরন: google.workspace.chat.spaces.v1.updated )।
  • সদস্যতা ইভেন্টগুলি পেতে, ব্যবহারকারীকে অবশ্যই স্থানের সরাসরি সদস্য হতে হবে। যদি কোনও ব্যবহারকারীকে Google গ্রুপের মাধ্যমে কোনও স্পেসে যোগ করা, আপডেট করা বা পরোক্ষভাবে সরিয়ে দেওয়া হয়, তাহলে সদস্যতা সেই সদস্যতা ইভেন্টগুলি গ্রহণ করে না। Google গোষ্ঠীর সদস্যপদগুলি কীভাবে কাজ করে তা বোঝার জন্য, একটি স্পেসে একটি Google গ্রুপ যুক্ত করুন দেখুন।