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

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

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

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

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

ইভেন্টগুলি কীভাবে কাজ করে

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

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

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

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

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

Google Chat থেকে ইভেন্টগুলি পান

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

  • ইভেন্টগুলি ঘটলে সেগুলি গ্রহণ করতে Google Workspace Events API ব্যবহার করে ইভেন্টগুলিতে সাবস্ক্রাইব করুন।
  • চ্যাট এপিআই-তে কল করে সাম্প্রতিক ইভেন্টগুলির জন্য অনুসন্ধান করুন।

নিম্নলিখিত টেবিলটি ইভেন্টগুলিতে জিজ্ঞাসা বা সাবস্ক্রাইব করার পার্থক্য এবং কারণগুলি ব্যাখ্যা করে:

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

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

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

উদাহরণ: কোনও স্পেসে মেম্বারশিপ সম্পর্কে ইভেন্টগুলি জিজ্ঞাসা করুন বা সাবস্ক্রাইব করুন

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

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

সদস্যপদ ইভেন্টগুলিতে সাবস্ক্রাইব করুন

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

চ্যাট অ্যাপ যা Google Workspace Events API ব্যবহার করে ইভেন্টগুলিতে সাবস্ক্রাইব করে।
চিত্র ২। একটি চ্যাট অ্যাপ Google Workspace Events API ব্যবহার করে সাবস্ক্রিপশনের মাধ্যমে সদস্যপদ ইভেন্টগুলি গ্রহণ করে।

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

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

সাম্প্রতিক সদস্যপদ ইভেন্টগুলির জন্য অনুসন্ধান

সদস্যপদ ইভেন্টগুলি ঘটলে তা গ্রহণ করার পরিবর্তে, একটি চ্যাট অ্যাপ সদস্যপদ কার্যকলাপের সাথে সম্পর্কিত সাম্প্রতিক স্পেস ইভেন্টগুলি তালিকাভুক্ত করতে চ্যাট API-তে কল করতে পারে।

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

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

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

সীমাবদ্ধতা

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