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

Google Chat-এ কীভাবে Google Chat অ্যাপ ইভেন্ট পেতে ও তার উত্তর দিতে পারে, তা এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে।

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

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

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

ইভেন্ট কীভাবে কাজ করে

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

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

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

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

অ্যাক্টিভিটি Chat API রিসোর্স ইভেন্টের প্রকার
কোনও ব্যবহারকারী Chat স্পেসে মেসেজ পোস্ট করেন Message রিসোর্স তৈরি করা হয়েছে। নতুন মেসেজ
কোনও ব্যবহারকারী স্পেস ম্যানেজার হয়েছেন। Membership রিসোর্স আপডেট করা হয়েছে। আপডেট করা মেম্বারশিপ
কোনও ব্যবহারকারী মেসেজে প্রতিক্রিয়া জানান। Reaction রিসোর্স তৈরি করা হয়েছে। নতুন প্রতিক্রিয়া
কোনও ব্যবহারকারী স্পেস ছেড়ে বেরিয়ে যান। Membership রিসোর্স মুছে ফেলা হয়েছে। মেম্বারশিপ মুছে ফেলা হয়েছে

Google Chat থেকে ইভেন্ট রিসিভ করুন

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

  • ইভেন্ট ঘটার সাথে সাথে তা পেতে Google Workspace Events API ব্যবহার করে ইভেন্টে সাবস্ক্রাইব করুন।
  • Chat API কল করে সাম্প্রতিক ইভেন্ট সম্পর্কে কোয়েরি করুন।

নিম্নলিখিত সারণীতে ইভেন্ট কোয়েরি করা বা সাবস্ক্রাইব করার মধ্যে পার্থক্য ও কারণ ব্যাখ্যা করা হয়েছে:

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

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

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

যেমন: কোনও স্পেসে মেম্বারশিপ সংক্রান্ত ইভেন্ট সম্পর্কে কোয়েরি করা বা সাবস্ক্রাইব করা

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

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

মেম্বারশিপ ইভেন্টে সাবস্ক্রাইব করুন

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

Chat অ্যাপ যা
      Google Workspace Events API ব্যবহার করে ইভেন্টে সাবস্ক্রাইব করে।
ছবি ২. Google Workspace Events API ব্যবহার করে সাবস্ক্রিপশনের মাধ্যমে Chat অ্যাপ মেম্বারশিপ ইভেন্ট পায়।

ছবি ২-এ, Chat অ্যাপের স্পেসে একটি অ্যাক্টিভ সাবস্ক্রিপশন আছে, তাই স্পেসে মেম্বারশিপ পরিবর্তন হলে অ্যাপটি একটি ইভেন্ট পায়। Chat অ্যাপ তখন রিয়েল টাইমে যেকোনও অ্যাক্টিভিটি প্রসেস করতে বা তার উত্তর দিতে পারে, যেমন স্পেসে যোগ দেওয়া মেম্বারকে ব্যক্তিগত স্বাগত মেসেজ পোস্ট করা।

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

সাম্প্রতিক মেম্বারশিপ ইভেন্ট সম্পর্কে কোয়েরি

মেম্বারশিপ ইভেন্ট ঘটার সাথে সাথে সেটির তথ্য পাওয়ার পরিবর্তে, Chat অ্যাপ, Chat API কল করে মেম্বারশিপ অ্যাক্টিভিটি সম্পর্কিত সাম্প্রতিক স্পেস ইভেন্টের তালিকা পেতে পারে।

Chat API ব্যবহার করে ইভেন্টের জন্য কোয়েরি করে এমন Chat অ্যাপ।
ছবি ৩. Chat API ব্যবহার করে স্পেস ইভেন্টের জন্য কোয়েরি করার মাধ্যমে Chat অ্যাপ সাম্প্রতিক মেম্বারশিপ ইভেন্ট রিসিভ করে।

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

Chat API ব্যবহার করে ইভেন্টের জন্য কোয়েরি করতে, Google Chat স্পেস থেকে ইভেন্টের তালিকা দেখুন।

সীমাবদ্ধতা ও ডেলিভারি সংক্রান্ত আচরণ

সাধারণ সীমাবদ্ধতা

  • মেম্বারশিপ ইভেন্ট পেতে, ব্যবহারকারী বা Chat অ্যাপকে স্পেসের সরাসরি মেম্বার হতে হবে। Google Group-এর মাধ্যমে কোনও স্পেসে পরোক্ষভাবে তাদের যোগ করা, আপডেট করা বা সরিয়ে দেওয়া হলে, সাবস্ক্রিপশন সেইসব মেম্বারশিপ ইভেন্ট পায় না। Google Group মেম্বারশিপ কীভাবে কাজ করে তা বুঝতে, স্পেসে Google Group যোগ করুন বিকল্প দেখুন।

ব্যবহারকারীর সাবস্ক্রিপশন

  • ব্যবহারকারীদের সাবস্ক্রিপশনের জন্য, সরাসরি মেসেজে বা নামহীন গ্রুপ চ্যাটে (google.workspace.chat.membership.v1.created) নতুন মেম্বারদের সম্পর্কে ইভেন্ট, শুধুমাত্র প্রথম মেসেজ পোস্ট করার পরে ট্রিগার করে।

গ্রাহকের সাবস্ক্রিপশন

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

  • Google Workspace সংস্থার কাছে অন্তত একটি Enterprise SKU লাইসেন্স থাকতে হবে।
  • একটি Chat অ্যাপ কোনও নির্দিষ্ট Google Workspace সংস্থার জন্য শুধুমাত্র একটি গ্রাহক সাবস্ক্রিপশন তৈরি করতে পারে। Google Workspace সংস্থার মোট পাঁচটি গ্রাহক সাবস্ক্রিপশন থাকতে পারে (বিভিন্ন Chat অ্যাপের মাধ্যমে তৈরি)।

গ্রাহকের সাবস্ক্রিপশনের জন্য, ইভেন্ট ডেলিভারি এইসব সাধারণ নিয়ম অনুসরণ করে:

  • স্পেস ইভেন্ট: আপনার Google Workspace সংস্থার ম্যানেজ করা স্পেসে ইভেন্ট ঘটলে তবেই ডেলিভার করা হয়।
  • ব্যবহারকারীর ইভেন্ট: আপনার Google Workspace সংস্থার অন্তর্গত কোনও ব্যবহারকারীর জন্য ইভেন্টটি ঘটলে তবেই ডেলিভার করা হয়।

এইসব নিয়মের একমাত্র ব্যতিক্রম হল মেম্বারশিপ ইভেন্ট। আপনার সাবস্ক্রিপশন আপনার প্রতিষ্ঠান দ্বারা ম্যানেজ করা স্পেস এবং এক্সটার্নাল প্রতিষ্ঠান দ্বারা ম্যানেজ করা স্পেস, উভয় থেকেই মেম্বারশিপ ইভেন্ট পেতে পারে, তবে সেগুলি কীভাবে ডেলিভার করা হবে তা নির্ভর করে কোন প্রতিষ্ঠান স্পেস ম্যানেজ করে তার উপর:

আপনার Google Workspace প্রতিষ্ঠান দ্বারা ম্যানেজ করা স্পেস

Google Workspace সংস্থার ম্যানেজ করা কোনও স্পেসে মেম্বারশিপ পরিবর্তন হলে, সেটি স্পেস ইভেন্ট হিসেবে ডেলিভার করা হয়।

স্পেস ইভেন্টের রিসোর্স নাম নিম্নলিখিত ফর্ম্যাট ব্যবহার করে:

spaces/{spaceId}/spaceEvents/{spaceEventId}

এক্সটার্নাল সংস্থার ম্যানেজ করা স্পেস

আপনার Google Workspace সংস্থার মাধ্যমে ম্যানেজ করা কোনও ব্যবহারকারীর মেম্বারশিপ যদি কোনও এক্সটার্নাল সংস্থার মাধ্যমে ম্যানেজ করা স্পেসে পরিবর্তন হয় (যেমন, কোনও এক্সটার্নাল নামযুক্ত স্পেস বা কোনও এক্সটার্নাল ব্যবহারকারীর মাধ্যমে তৈরি করা ডাইরেক্ট মেসেজ), তাহলে আপনার সাবস্ক্রিপশন এই ইভেন্টকে ব্যবহারকারী ইভেন্ট হিসেবে গ্রহণ করে।

ব্যবহারকারীর ইভেন্টের রিসোর্স নাম নিম্নলিখিত ফর্ম্যাট ব্যবহার করে:

users/{userId}/userEvents/{userEventId}