ঘটনা বস্তু

এই পৃষ্ঠায় গুগল ওয়ার্কস্পেস অ্যাড-অন ইভেন্ট অবজেক্টগুলোর গঠন সম্পর্কে বর্ণনা করা হয়েছে।

ইভেন্ট অবজেক্ট হলো JSON কাঠামো যা স্বয়ংক্রিয়ভাবে তৈরি হয় এবং কোনো ব্যবহারকারী যখন একটি অ্যাড-অনের সাথে ইন্টারঅ্যাক্ট করে তখন ট্রিগার বা কলব্যাক ফাংশনে প্যারামিটার হিসেবে পাঠানো হয়। ইভেন্ট অবজেক্টগুলো হোস্ট অ্যাপ সম্পর্কিত ক্লায়েন্ট-সাইড তথ্য এবং বর্তমান প্রেক্ষাপট অ্যাড-অনটির সার্ভার-সাইড কলব্যাক ফাংশনে বহন করে নিয়ে যায়।

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলি নিম্নলিখিত স্থানগুলিতে ইভেন্ট অবজেক্ট ব্যবহার করে:

• হোমপেজ ট্রিগার । আপনার সংজ্ঞায়িত প্রতিটি homepageTrigger ফাংশন ফায়ার হলে, সেটিতে স্বয়ংক্রিয়ভাবে একটি ইভেন্ট অবজেক্ট পাস করা হয়। আপনি আপনার হোমপেজ ট্রিগার ফাংশনে এই অবজেক্টটি ব্যবহার করে সক্রিয় হোস্ট অ্যাপ, ক্লায়েন্টের প্ল্যাটফর্ম, ব্যবহারকারীর লোকেল এবং অন্যান্য তথ্য শনাক্ত করতে পারেন।

  হোমপেজ ট্রিগার সক্রিয় হলে যে ইভেন্ট অবজেক্টগুলো তৈরি হয়, সেগুলোতে অন্যান্য ক্ষেত্রে অন্তর্ভুক্ত সমস্ত ফিল্ড থাকে না; উইজেট এবং প্রাসঙ্গিক তথ্য সম্পর্কিত ফিল্ডগুলো বাদ দেওয়া হয়।

• প্রাসঙ্গিক ট্রিগার । প্রতিটি হোস্ট অ্যাপ্লিকেশন ভিন্ন ভিন্ন প্রাসঙ্গিক ট্রিগার সরবরাহ করে, যেগুলো ব্যবহারকারী কোনো নির্দিষ্ট প্রসঙ্গে প্রবেশ করলে সক্রিয় হয়:

  • যখন ব্যবহারকারী:
    • একটি বার্তা খোলে
    • একটি বার্তা রচনা করে ।
    • একটি ইভেন্ট চালু করে ।
  • যখন কোনো ব্যবহারকারী ড্রাইভ ফাইল নির্বাচন করেন , তখন গুগল ড্রাইভ একটি প্রাসঙ্গিক ট্রিগার প্রদান করে।

  যখন একটি কনটেক্সচুয়াল ট্রিগার সক্রিয় হয়, তখন হোস্ট অ্যাপ্লিকেশনটি অ্যাড-অন ম্যানিফেস্টে তালিকাভুক্ত সংশ্লিষ্ট runFunction কল করে এবং প্যারামিটার হিসেবে একটি ইভেন্ট অবজেক্ট পাস করে। কনটেক্সচুয়াল ট্রিগার সক্রিয় হলে যে ইভেন্ট অবজেক্টগুলো তৈরি হয়, সেগুলোতে হোমপেজ ট্রিগার ইভেন্ট অবজেক্টের অন্তর্ভুক্ত সমস্ত ফিল্ডের পাশাপাশি প্রাসঙ্গিক তথ্য সম্বলিত ফিল্ডও থাকে।

• উইজেট অ্যাকশন । ইভেন্ট অবজেক্টগুলো জিমেইল অ্যাড-অনগুলোর ব্যবহৃত অ্যাকশন মডেলের মতোই উইজেটের ইন্টারঅ্যাক্টিভিটি প্রদান করে। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলো একই উইজেট হ্যান্ডলার ফাংশন, Action অবজেক্ট এবং অ্যাকশন রেসপন্স ব্যবহার করে। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলোতে, অ্যাকশন ইভেন্ট অবজেক্টগুলোতে আরও বেশি তথ্য থাকে, যার ওপর ভিত্তি করে একটি কলব্যাক ফাংশন কাজ করতে পারে।

  উইজেট অ্যাকশন থেকে তৈরি ইভেন্ট অবজেক্টগুলিতে কনটেক্সচুয়াল ট্রিগার ইভেন্ট অবজেক্টের অন্তর্ভুক্ত সমস্ত ফিল্ডের পাশাপাশি উইজেটের তথ্য ধারণকারী ফিল্ডও থাকে।

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

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

ইভেন্ট অবজেক্ট কাঠামো

নিম্নলিখিত সারণীটি গুগল ওয়ার্কস্পেস অ্যাড-অন ইভেন্ট অবজেক্টগুলির শীর্ষ-স্তরের কাঠামো বর্ণনা করে। এই কাঠামোতে হোস্ট-নিরপেক্ষ তথ্যের জন্য একটি commonEventObject শীর্ষ-স্তরের ফিল্ড অন্তর্ভুক্ত রয়েছে। প্রতিটি ইভেন্ট অবজেক্টে সক্রিয় হোস্ট অ্যাপ দ্বারা নির্ধারিত নিম্নলিখিত হোস্ট-নির্দিষ্ট শীর্ষ-স্তরের ফিল্ডগুলির মধ্যে একটিও থাকতে পারে: gmailEventObject , calendarEventObject , বা driveEventObject ।

পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যতা বজায় রাখার জন্য, গুগল ওয়ার্কস্পেস অ্যাড-অন ইভেন্ট অবজেক্টগুলোতে জিমেইল অ্যাড-অন অ্যাকশন ইভেন্ট অবজেক্টে ব্যবহৃত মূল ফিল্ডগুলো অন্তর্ভুক্ত থাকে। এই ফিল্ডগুলো "Original Gmail add-on fields"-এর অধীনে থাকে এবং commonEventObject এর অংশ নয়।

মূল Gmail অ্যাড-অন ফিল্ডগুলো এখন আর ব্যবহারযোগ্য নয়। Google Workspace অ্যাড-অন তৈরি বা মাইগ্রেট করার সময়, এর পরিবর্তে নতুন ইভেন্ট অবজেক্ট কাঠামো ব্যবহার করুন। ভবিষ্যতের কোনো আপডেটে এই ফিল্ডগুলো সরিয়ে ফেলা হতে পারে।

সাধারণ ঘটনা বস্তু

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

হোমপেজ এবং প্রাসঙ্গিক ট্রিগার ছাড়াও, ব্যবহারকারী যখন উইজেটগুলির সাথে ইন্টারঅ্যাক্ট করে, তখন অ্যাড-অনগুলি ইভেন্ট অবজেক্ট তৈরি করে এবং অ্যাকশন কলব্যাক ফাংশনে পাঠায়। আপনার অ্যাড-অনের কলব্যাক ফাংশনটি ব্যবহারকারীর ক্লায়েন্টে খোলা উইজেটগুলির বিষয়বস্তু নির্ধারণ করতে কমন ইভেন্ট অবজেক্টটি কোয়েরি করতে পারে। উদাহরণস্বরূপ, আপনার অ্যাড-অনটি eventObject.commentEventObject.formInputs অবজেক্টের মধ্যে ব্যবহারকারীর TextInput উইজেটে প্রবেশ করানো টেক্সটটি খুঁজে বের করতে পারে।

তারিখ-সময় বাছাই ফর্ম ইনপুট

অ্যাকশন কলব্যাক ফাংশনগুলো commonEventObject.formInputs ফিল্ডে বর্তমান উইজেটের মান গ্রহণ করতে পারে। এর মধ্যে ডেট বা টাইম পিকার উইজেটে ব্যবহারকারীর নির্বাচিত তারিখ বা সময়ের মান অন্তর্ভুক্ত থাকে। উইজেটটি ডেট-টাইম পিকার, শুধুমাত্র তারিখ পিকার, নাকি শুধুমাত্র সময় পিকার হিসেবে কনফিগার করা হয়েছে, তার উপর নির্ভর করে তথ্যের কাঠামো ভিন্ন হয়। কাঠামোগত পার্থক্যগুলো নিম্নলিখিত সারণীতে বর্ণনা করা হয়েছে:

চ্যাট ইভেন্ট অবজেক্ট

চ্যাট ইভেন্ট অবজেক্ট হলো সামগ্রিক ইভেন্ট অবজেক্টের সেই অংশ যা একটি চ্যাট অ্যাপের সাথে ব্যবহারকারীর মিথস্ক্রিয়া সম্পর্কিত তথ্য বহন করে। এটি একটি ইভেন্ট অবজেক্টে কেবল তখনই উপস্থিত থাকে, যদি অ্যাড-অনটি Google Chat-কে এক্সটেন্ড করে ।

পেলোড

চ্যাট অ্যাপের ইন্টারঅ্যাকশনের ধরনের ওপর নির্ভর করে, ইভেন্টটিতে এক বা একাধিক চ্যাট এপিআই রিসোর্সসহ একটি পেলোড থাকে।

"docs" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}
        

"sheets" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}
        

"slides" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}