ঘটনা বস্তু

এই পৃষ্ঠাটি Google Workspace অ্যাড-অন ইভেন্ট অবজেক্টের কাঠামোর রূপরেখা দেয়।

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

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

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

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

  • কনটেক্সচুয়াল ট্রিগার । প্রতিটি হোস্ট অ্যাপ্লিকেশন কনটেক্সচুয়াল ট্রিগারের একটি ভিন্ন সেট প্রদান করে যা ব্যবহারকারী যখন একটি নির্দিষ্ট কনটেক্সটে প্রবেশ করে তখন কার্যকর হয়। উদাহরণস্বরূপ:

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

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

    উইজেট অ্যাকশনের ফলে তৈরি ইভেন্ট অবজেক্টগুলিতে প্রাসঙ্গিক ট্রিগার ইভেন্ট অবজেক্টের অন্তর্ভুক্ত সমস্ত ক্ষেত্র থাকে, এবং উইজেট তথ্য ধারণকারী ক্ষেত্রও থাকে।

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

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

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

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

ব্যাকওয়ার্ড কম্প্যাটিবিলিটির জন্য, Google Workspace অ্যাড-অন ইভেন্ট অবজেক্টগুলিতে Gmail অ্যাড-অন অ্যাকশন ইভেন্ট অবজেক্টে ব্যবহৃত সমস্ত মূল ক্ষেত্রও অন্তর্ভুক্ত থাকে। এই ক্ষেত্রগুলি "অরিজিনাল জিমেইল অ্যাড-অন ফিল্ড" এর অধীনে নীচের সারণীতে তালিকাভুক্ত করা হয়েছে; এই ক্ষেত্রগুলির তথ্য নতুন অবজেক্ট স্ট্রাকচারে পুনরুত্পাদন করা হয়।

ইভেন্ট অবজেক্ট
eventObject.commonEventObject Common fields object
হোস্ট অ্যাপ্লিকেশন নির্বিশেষে, সমস্ত ইভেন্ট অবজেক্টের জন্য সাধারণ তথ্য ধারণকারী একটি অবজেক্ট।
eventObject.calendar Calendar event object
কলিং হোস্ট যদি Google Calendar হয় তবেই এটি উপস্থিত হবে । ক্যালেন্ডার এবং ইভেন্টের তথ্য সম্বলিত একটি অবজেক্ট।
eventObject.chat Chat event object
কলিং হোস্ট যদি Google Chat হয় তবেই কেবল উপস্থিত হবে । চ্যাটের তথ্য সম্বলিত একটি অবজেক্ট।
eventObject.drive Drive event object
কলিং হোস্ট যদি Google ড্রাইভ হয় তবেই কেবল উপস্থিত হবে । ড্রাইভের তথ্য সম্বলিত একটি অবজেক্ট।
eventObject.gmail Gmail event object
কলিং হোস্ট যদি Gmail হয় তবেই কেবল উপস্থিত হবে । Gmail তথ্য সম্বলিত একটি বস্তু।
eventObject.docs Docs event object
কলিং হোস্ট যদি Google Docs হয় তবেই এটি উপস্থিত হবে । Docs তথ্য সম্বলিত একটি অবজেক্ট।
eventObject.sheets Sheets event object
কলিং হোস্ট যদি Google Sheets হয় তবেই এটি উপস্থিত হবে । Sheets তথ্য সম্বলিত একটি অবজেক্ট।
eventObject.slides Slides event object
কলিং হোস্ট যদি Google Slides হয় তবেই কেবল উপস্থিত হবে । স্লাইডের তথ্য সম্বলিত একটি অবজেক্ট।
আসল জিমেইল অ্যাড-অন ক্ষেত্রগুলি
eventObject.messageMetadata.accessToken string
বন্ধ করে দেওয়া হয়েছে। একটি অ্যাক্সেস টোকেন। আপনি অস্থায়ী Gmail অ্যাড-অন স্কোপ ব্যবহার করে ব্যবহারকারীর ডেটা অ্যাক্সেস চালু করতে এটি ব্যবহার করতে পারেন।

Google Workspace অ্যাড-অনের জন্য, eventObject.gmail.accessToken ফিল্ডে এই তথ্যটি খুঁজুন।

eventObject.messageMetadata.messageId string
বন্ধ করা হয়েছে। থ্রেডের মেসেজ আইডিটি Gmail UI-তে খোলা আছে।

Google Workspace অ্যাড-অনের জন্য, eventObject.gmail.messageId ফিল্ডে এই তথ্যটি খুঁজুন।

eventObject.clientPlatform string
বন্ধ করা হয়েছে। ইভেন্টটি কোথা থেকে এসেছে তা নির্দেশ করে (ওয়েব, iOS, অথবা Android)।

Google Workspace অ্যাড-অনের জন্য, eventObject.commonEventObject.platform ফিল্ডে এই তথ্যটি খুঁজুন।

eventObject.formInput object
অবচিত। কার্ডের সমস্ত ফর্ম উইজেটের বর্তমান মানের একটি মানচিত্র, প্রতিটি উইজেটের জন্য একটি মানের মধ্যে সীমাবদ্ধ। কীগুলি হল উইজেটের সাথে যুক্ত স্ট্রিং আইডি এবং মানগুলি হল স্ট্রিং। ইভেন্ট অবজেক্টটি formInput প্রদান করে যখন আপনাকে একাধিক উইজেট থেকে প্রত্যাশিত একক মান, যেমন টেক্সট ইনপুট এবং সুইচ সহ ডেটা পড়ার প্রয়োজন হয়, তখন সুবিধার্থে। চেকবক্সের মতো বহু-মূল্যবান উইজেটের জন্য, আপনি formInputs থেকে প্রতিটি মান পড়তে পারেন।

Google Workspace অ্যাড-অনের জন্য, eventObject.commonEventObject.formInputs ফিল্ডে এই তথ্যটি খুঁজুন; একক মান সহ উইজেটগুলিকে একটি একক উপাদান সহ অ্যারে হিসাবে উপস্থাপন করা হয়।

eventObject.formInputs object
অবচিত। কার্ডে উইজেটের বর্তমান মানগুলির একটি মানচিত্র, যা স্ট্রিংগুলির তালিকা হিসাবে উপস্থাপিত। কীগুলি হল উইজেটের সাথে সম্পর্কিত স্ট্রিং আইডি। একক-মূল্যবান উইজেটের জন্য, মানটি একটি একক-উপাদান অ্যারেতে উপস্থাপিত হয়। চেকবক্স গ্রুপের মতো বহু-মূল্যবান উইজেটের জন্য, সমস্ত মান একটি তালিকায় উপস্থাপিত হয়।

Google Workspace অ্যাড-অনের জন্য, eventObject.commonEventObject.formInputs ফিল্ডে এই তথ্যটি খুঁজুন।

eventObject.parameters object
অবচিত। Action.setParameters() ব্যবহার করে Action এ আপনার সরবরাহ করা যেকোনো অতিরিক্ত প্যারামিটারের একটি মানচিত্র। মানচিত্র কী এবং মানগুলি হল স্ট্রিং।

Google Workspace অ্যাড-অনের জন্য, eventObject.commonEventObject.parameters ফিল্ডে এই তথ্যটি খুঁজুন।

eventObject.userCountry string
ডিফল্টরূপে অবচিত এবং অক্ষম । ব্যবহারকারীর দেশ বা অঞ্চল নির্দেশ করে এমন দুই-অক্ষরের কোড। এটি একটি সংখ্যাসূচক UN M49 দেশের কোডও হতে পারে।

Google Workspace অ্যাড-অনের জন্য, eventObject.commonEventObject.userLocale ফিল্ডে এই তথ্যটি খুঁজুন।

eventObject.userLocale string
ডিফল্টরূপে অবচিত এবং অক্ষম । দুই অক্ষরের ISO 639 কোড যা ব্যবহারকারীর ভাষা নির্দেশ করে। আরও বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং সময় অঞ্চল অ্যাক্সেস করা দেখুন।

Google Workspace অ্যাড-অনের জন্য, eventObject.commonEventObject.userLocale ফিল্ডে এই তথ্যটি খুঁজুন।

eventObject.userTimezone.id string
ডিফল্টরূপে অবচিত এবং অক্ষম । ব্যবহারকারীর টাইমজোনের টাইমজোন শনাক্তকারী । উদাহরণগুলির মধ্যে রয়েছে: America/New_York , Europe/Vienna , এবং Asia/Seoul । আরও বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন।

Google Workspace অ্যাড-অনের জন্য, eventObject.commonEventObject.timeZone.id ফিল্ডে এই তথ্যটি খুঁজুন।

eventObject.userTimezone.offset string
ডিফল্টরূপে বন্ধ এবং অক্ষম করা হয়েছে । ব্যবহারকারীর টাইমজোনের কোঅর্ডিনেটেড ইউনিভার্সাল টাইম (UTC) থেকে অফসেট করা সময় , মিলিসেকেন্ডে পরিমাপ করা হয়। আরও বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন।

Google Workspace অ্যাড-অনের জন্য, eventObject.commonEventObject.timeZone.offset ফিল্ডে এই তথ্যটি খুঁজুন।

সাধারণ ইভেন্ট অবজেক্ট

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

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

সাধারণ ইভেন্ট অবজেক্ট ফিল্ড
commonEventObject.platform string
ইভেন্টটি কোথা থেকে উৎপত্তি তা নির্দেশ করে (`WEB`, `IOS`, অথবা `ANDROID`)।
commonEventObject.formInputs object
প্রদর্শিত কার্ডে উইজেটের বর্তমান মান সম্বলিত একটি মানচিত্র। মানচিত্র কীগুলি হল প্রতিটি উইজেটের সাথে নির্ধারিত স্ট্রিং আইডি।

ম্যাপ ভ্যালু অবজেক্টের গঠন উইজেটের ধরণের উপর নির্ভরশীল:

  • একক-মূল্যবান উইজেট (উদাহরণস্বরূপ, একটি টেক্সট বক্স): স্ট্রিংগুলির একটি তালিকা (শুধুমাত্র একটি উপাদান)।

    উদাহরণ : একটি টেক্সট ইনপুট উইজেটের জন্য যার আইডি employeeName , টেক্সট ইনপুট মানটি ব্যবহার করে অ্যাক্সেস করুন: e.commonEventObject.formInputs.employeeName.stringInputs.value[0]

  • বহু-মূল্যবান উইজেট (উদাহরণস্বরূপ, চেকবক্স গ্রুপ): স্ট্রিংগুলির একটি তালিকা।

    উদাহরণ : একটি মাল্টি-ভ্যালু উইজেটের জন্য যেখানে participants আইডি হিসেবে রাখা হয়, মান অ্যারেটি ব্যবহার করে অ্যাক্সেস করুন: e.commonEventObject.formInputs.participants.stringInputs.value ।

  • A date-time picker : একটি DateTimeInput object ।

    উদাহরণ : myDTPicker এর আইডি সহ একটি পিকারের জন্য, e.commonEventObject.formInputs.myDTPicker.dateTimeInput ব্যবহার করে DateTimeInput অবজেক্টটি অ্যাক্সেস করুন।

  • A date-only picker : একটি DateInput object ।

    উদাহরণ : myDatePicker আইডি সহ একটি পিকারের জন্য, e.commonEventObject.formInputs.myDatePicker.dateInput ব্যবহার করে DateInput অবজেক্টটি অ্যাক্সেস করুন।

  • A time-only picker : একটি TimeInput object ।

    উদাহরণ : myTimePicker আইডি সহ একটি পিকারের জন্য, e.commonEventObject.formInputs.myTimePicker.timeInput ব্যবহার করে TimeInput অবজেক্টটি অ্যাক্সেস করুন।

commonEventObject.hostApp string
ইভেন্ট অবজেক্ট তৈরি হওয়ার সময় অ্যাড-অনটি যে হোস্ট অ্যাপে সক্রিয় থাকে তা নির্দেশ করে। সম্ভাব্য মানগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
  • GMAIL
  • CALENDAR
  • DRIVE
  • DOCS
  • SHEETS
  • SLIDES
commonEventObject.parameters object
actionParameters অথবা Action.setParameters() ব্যবহার করে আপনি কোনও অ্যাকশনে যে কোনও অতিরিক্ত প্যারামিটার সরবরাহ করেন।

ডেভেলপার প্রিভিউ: গুগল চ্যাটকে প্রসারিত করে এমন অ্যাড-অনগুলির জন্য, মাল্টিসিলেক্ট মেনুতে ব্যবহারকারীরা কী টাইপ করেন তার উপর ভিত্তি করে আইটেমগুলি সুপারিশ করতে, "autocomplete_widget_query" কী ( event.commonEventObject.parameters["autocomplete_widget_query"] ) এর মান ব্যবহার করুন। আপনি এই মানটি একটি ডাটাবেস অনুসন্ধান করতে এবং ব্যবহারকারীরা টাইপ করার সময় নির্বাচনযোগ্য আইটেমগুলি সুপারিশ করতে ব্যবহার করতে পারেন। বিস্তারিত জানার জন্য, গুগল চ্যাট ব্যবহারকারীদের কাছ থেকে তথ্য সংগ্রহ এবং প্রক্রিয়াকরণ দেখুন।

commonEventObject.userLocale string
ডিফল্টরূপে অক্ষম । ব্যবহারকারীর ভাষা এবং দেশ/অঞ্চল শনাক্তকারী ISO 639 ভাষা কোড- ISO 3166 দেশ/অঞ্চল কোডের বিন্যাসে। উদাহরণস্বরূপ, en-US ।

এই ক্ষেত্রটি চালু করতে, আপনার অ্যাড-অনের ম্যানিফেস্টে addOns.common.useLocaleFromApp কে true তে সেট করতে হবে। আপনার অ্যাড-অনের স্কোপ তালিকায় https://www.googleapis.com/auth/script.locale ও অন্তর্ভুক্ত থাকতে হবে। আরও বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন।

commonEventObject.timeZone string
ডিফল্টরূপে অক্ষম । টাইমজোন আইডি এবং অফসেট। এই ক্ষেত্রটি চালু করতে, আপনার অ্যাড-অনের ম্যানিফেস্টে addOns.common.useLocaleFromApp কে true তে সেট করতে হবে। আপনার অ্যাড-অনের স্কোপ তালিকায় https://www.googleapis.com/auth/script.locale ও অন্তর্ভুক্ত থাকতে হবে। আরও বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন।
commonEventObject.timeZone.id string
ব্যবহারকারীর টাইমজোনের টাইমজোন শনাক্তকারী । উদাহরণগুলির মধ্যে রয়েছে: America/New_York , Europe/Vienna , এবং Asia/Seoul . এই ক্ষেত্রটি চালু করতে, আপনার অ্যাড-অনের ম্যানিফেস্টে addOns.common.useLocaleFromApp true তে সেট করতে হবে। আপনার অ্যাড-অনের স্কোপ তালিকায় https://www.googleapis.com/auth/script.locale ও অন্তর্ভুক্ত থাকতে হবে। আরও বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন।
commonEventObject.timeZone.offset string
ব্যবহারকারীর টাইমজোনের কোঅর্ডিনেটেড ইউনিভার্সাল টাইম (UTC) থেকে অফসেট করা সময় , মিলিসেকেন্ডে পরিমাপ করা হয়। আরও বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন।

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

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

DateTimeInput অবজেক্ট
dateTimeInput.hasDate boolean
যদি ইনপুট তারিখের সময় একটি তারিখ অন্তর্ভুক্ত করে তবে true ; যদি false তবে কেবল একটি সময় অন্তর্ভুক্ত করা হয়।
dateTimeInput.hasTime boolean
যদি তারিখের সময় ইনপুট করা থাকে তাহলে true ; যদি false তাহলে শুধুমাত্র একটি তারিখ অন্তর্ভুক্ত করা হবে।
dateTimeInput.msSinceEpoch string
ব্যবহারকারী কর্তৃক নির্বাচিত সময়, যুগের পর থেকে মিলিসেকেন্ডে (১ জানুয়ারী ১৯৭০ তারিখে ০০:০০:০০ UTC)।
তারিখ ইনপুট বস্তু
dateInput.msSinceEpoch string
ব্যবহারকারী কর্তৃক নির্বাচিত সময়, যুগের পর থেকে মিলিসেকেন্ডে (১ জানুয়ারী ১৯৭০ তারিখে ০০:০০:০০ UTC)।
টাইমইনপুট অবজেক্ট
timeInput.hours number
ব্যবহারকারীর দ্বারা নির্বাচিত ঘন্টা সংখ্যা।
timeInput.minutes number
ব্যবহারকারী কর্তৃক নির্বাচিত মিনিট সংখ্যা।

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

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

চ্যাট
chat.user object ( User )
যে চ্যাট ব্যবহারকারী চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করেছেন।
chat.space object ( Space )
চ্যাট স্পেস যেখানে একজন ব্যবহারকারী চ্যাট অ্যাপের সাথে ইন্টারঅ্যাক্ট করেছিলেন।
chat.eventTime

string ( Timestamp format)

যে সময় মিথস্ক্রিয়াটি ঘটেছিল।

ইউনিয়ন ফিল্ড payload ।

payload নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

chat.messagePayload

object ( MessagePayload )

মেসেজ ট্রিগার থেকে চ্যাট অ্যাপগুলি যে পেলোড পায়।

chat.addedToSpacePayload

object ( AddedToSpacePayload )

অ্যাড টু স্পেস ট্রিগার থেকে চ্যাট অ্যাপগুলি যে পেলোড পায়।

chat.removedFromSpacePayload

object ( RemovedFromSpacePayload )

Removed from space ট্রিগার থেকে Chat অ্যাপগুলি যে পেলোড পায়।

chat.buttonClickedPayload

object ( ButtonClickedPayload )

ব্যবহারকারীরা যখন কোনও বার্তা বা কার্ড থেকে কোনও বোতামে ক্লিক করেন তখন চ্যাট অ্যাপগুলি যে পেলোড পায়। যদি কোনও ব্যবহারকারী তথ্য জমা দেওয়ার জন্য কোনও বোতামে ক্লিক করেন, তাহলে commonEventObject.formInputs অবজেক্টে ব্যবহারকারীর কাছ থেকে সংগৃহীত মান থাকে। বিস্তারিত জানার জন্য, Google Chat ব্যবহারকারীদের কাছ থেকে তথ্য সংগ্রহ করুন দেখুন।

chat.widgetUpdatedPayload

object ( WidgetUpdatedPayload )

ব্যবহারকারীরা যখন একটি selectionInput উইজেটের মাল্টিসিলেক্ট মেনুতে টেক্সট টাইপ করেন তখন Chat অ্যাপগুলি যে পেলোড পায়। চ্যাট অ্যাপগুলি এই ইভেন্ট অবজেক্ট ব্যবহার করে একটি ডায়নামিক ডেটা সোর্স থেকে প্রস্তাবিত আইটেমগুলি পূরণ করতে পারে। উদাহরণস্বরূপ, একটি বহিরাগত ডেটা সোর্স থেকে সহায়তা কেসগুলি পূরণ করতে, একটি Chat অ্যাপ ব্যবহারকারী মেনুতে কী টাইপ করে তার উপর ভিত্তি করে ডেটা সোর্সটি জিজ্ঞাসা করতে পারে এবং তারপরে যেকোনো মিলিত সহায়তা কেস নির্বাচনযোগ্য আইটেম হিসাবে ফিরিয়ে দিতে পারে।

CommonEventObject.parameters['autocomplete_widget_query'] অবজেক্টে ব্যবহারকারীর মেনুতে টাইপ করা স্ট্রিং মান থাকে।

chat.appCommandPayload

object ( AppCommandPayload )

একজন ব্যবহারকারী যখন চ্যাট অ্যাপ থেকে কোনও কমান্ড ব্যবহার করেন তখন চ্যাট অ্যাপগুলি যে পেলোড গ্রহণ করে।

পেলোড

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

বার্তা পেলোড
মেসেজপেলোড
chat.messagePayload.message object ( Message )
যে চ্যাট মেসেজটি ইভেন্টটি ট্রিগার করেছিল।
chat.messagePayload.space object ( Space )
যে চ্যাট স্পেসে একজন ব্যবহারকারী চ্যাট অ্যাপের জন্য বার্তা পাঠিয়েছিলেন।
chat.messagePayload.configCompleteRedirectUri string
Google Chat-এর বাইরে কোনও অনুমোদন বা কনফিগারেশন ফ্লো সম্পন্ন করার পরে ব্যবহারকারীকে Chat অ্যাপটি যে URL-এ রিডাইরেক্ট করবে। আরও তথ্যের জন্য, আপনার Google Workspace অ্যাড-অনকে একটি তৃতীয় পক্ষের পরিষেবার সাথে সংযুক্ত করুন দেখুন।

স্পেস পেলোডে যোগ করা হয়েছে
যোগ করা হয়েছেস্পেসপেলোড
chat.addedToSpacePayload.space object ( Space )
ব্যবহারকারী যে চ্যাট স্পেসে চ্যাট অ্যাপটি যোগ করেছেন বা ইনস্টল করেছেন।

যখন অ্যাডমিনিস্ট্রেটররা চ্যাট অ্যাপ ইনস্টল করেন, তখন space.adminInstalled ফিল্ডটি true তে সেট করা থাকে।

chat.addedToSpacePayload.interactionAdd boolean
কোনও ব্যবহারকারী কোনও বার্তা ব্যবহার করে কোনও স্পেসে চ্যাট অ্যাপ যোগ করেন কিনা। উদাহরণস্বরূপ, @চ্যাট অ্যাপটি উল্লেখ করে বা কোনও কমান্ড ব্যবহার করে। যদি true , তাহলে চ্যাট একটি messagePayload সহ আরেকটি ইভেন্ট অবজেক্ট পাঠায় যাতে বার্তা সম্পর্কে তথ্য থাকে।
chat.addedToSpacePayload.configCompleteRedirectUri string
Google Chat-এর বাইরে কোনও অনুমোদন বা কনফিগারেশন ফ্লো সম্পন্ন করার পরে ব্যবহারকারীকে Chat অ্যাপটি যে URL-এ রিডাইরেক্ট করবে। আরও তথ্যের জন্য, আপনার Google Workspace অ্যাড-অনকে একটি তৃতীয় পক্ষের পরিষেবার সাথে সংযুক্ত করুন দেখুন।

স্পেস পেলোড থেকে সরানো হয়েছে
স্থান থেকে সরানো হয়েছেপেলোড
chat.removedFromSpacePayload.space object ( Space )
যে চ্যাট স্পেস থেকে ব্যবহারকারী চ্যাট অ্যাপটি সরিয়েছেন বা আনইনস্টল করেছেন।

যখন অ্যাডমিনিস্ট্রেটররা চ্যাট অ্যাপ আনইনস্টল করেন, তখন space.adminInstalled ফিল্ডটি false তে সেট করা হয়।

বোতামে ক্লিক করা পেলোড
বোতামে ক্লিক করা পেলোড
chat.buttonClickedPayload.message object ( Message )
চ্যাট মেসেজে ব্যবহারকারীর ক্লিক করা বোতামটি থাকে।
chat.buttonClickedPayload.space object ( Space )
চ্যাট স্পেস যেখানে ব্যবহারকারী চ্যাট অ্যাপের বার্তা থেকে একটি বোতামে ক্লিক করেছেন।
chat.buttonClickedPayload.isDialogEvent boolean
ব্যবহারকারী কোনও ডায়ালগের সাথে ইন্টারঅ্যাক্ট করার জন্য বোতামটি ক্লিক করেছেন কিনা।
chat.buttonClickedPayload.dialogEventType enum ( DialogEventType )
যদি isDialogEvent true হয়, তাহলে একটি ডায়ালগে ইন্টারঅ্যাকশনের ধরণ।

Enum DialogEventType ।

dialogEventType এর মান নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

TYPE_UNSPECIFIED ডিফল্ট মান। অনির্দিষ্ট।
REQUEST_DIALOG একজন ব্যবহারকারী একটি ডায়ালগের অনুরোধ করেন। উদাহরণস্বরূপ, তারা একটি কমান্ড ব্যবহার করেন অথবা একটি বার্তা থেকে একটি বোতামে ক্লিক করেন।
SUBMIT_DIALOG একজন ব্যবহারকারী একটি ডায়ালগের মধ্যে একটি ইন্টারেক্টিভ উপাদানে ক্লিক করেন। উদাহরণস্বরূপ, একজন ব্যবহারকারী একটি ডায়ালগে তথ্য পূরণ করেন এবং তথ্য জমা দেওয়ার জন্য একটি বোতামে ক্লিক করেন।

উইজেট আপডেট করা পেলোড
উইজেটআপডেটপেলোড
chat.widgetUpdatedPayload.space object ( Space )
চ্যাট স্পেস যেখানে মিথস্ক্রিয়াটি হয়েছিল।

অ্যাপ কমান্ড পেলোড
অ্যাপকমান্ডপেলোড
chat.appCommandPayload.appCommandMetadata object ( AppCommandMetadata )
ব্যবহারকারী কোন কমান্ড ব্যবহার করেছেন এবং কীভাবে তারা কমান্ডটি ট্রিগার করেছেন তার মেটাডেটা।
chat.appCommandPayload.space object ( Space )
যে চ্যাট স্পেসটিতে একজন ব্যবহারকারী কমান্ডটি ব্যবহার করেছেন।
chat.appCommandPayload.thread object ( Thread )
যদি কোনও থ্রেডে ইন্টারঅ্যাকশন ঘটে থাকে, তাহলে চ্যাট থ্রেড যেখানে ব্যবহারকারী কমান্ডটি ব্যবহার করেছেন।
chat.appCommandPayload.message object ( Message )
স্ল্যাশ কমান্ডের জন্য, যে বার্তায় স্ল্যাশ কমান্ড থাকে।
chat.appCommandPayload.configCompleteRedirectUri string
যদি কমান্ডের জন্য অনুমোদন বা কনফিগারেশনের প্রয়োজন হয়, তাহলে ব্যবহারকারী Google Chat-এর বাইরে প্রক্রিয়াটি সম্পন্ন করার পরে তাকে পুনঃনির্দেশিত করার জন্য একটি URL।
chat.appCommandPayload.isDialogEvent boolean
কমান্ডটি একটি ডায়ালগ খোলে কিনা।
chat.appCommandPayload.dialogEventType enum ( DialogEventType )
একটি সংলাপের সাথে মিথস্ক্রিয়ার ধরণ।

Enum DialogEventType ।

dialogEventType এর মান নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

TYPE_UNSPECIFIED ডিফল্ট মান। অনির্দিষ্ট।
REQUEST_DIALOG একজন ব্যবহারকারী একটি ডায়ালগের অনুরোধ করেন। উদাহরণস্বরূপ, তারা একটি কমান্ড ব্যবহার করেন অথবা একটি বার্তা থেকে একটি বোতামে ক্লিক করেন।
SUBMIT_DIALOG একজন ব্যবহারকারী একটি ডায়ালগের মধ্যে একটি ইন্টারেক্টিভ উপাদানে ক্লিক করেন। উদাহরণস্বরূপ, একজন ব্যবহারকারী একটি ডায়ালগে তথ্য পূরণ করেন এবং তথ্য জমা দেওয়ার জন্য একটি বোতামে ক্লিক করেন।
অ্যাপ কমান্ড মেটাডেটা
অ্যাপকমান্ডমেটাডেটা
chat.appCommandPayload.appCommandMetadata.appCommandId

string ( int64 format)

কমান্ড আইডি।

chat.appCommandPayload.appCommandMetadata.appCommandType enum ( AppCommandType )
কমান্ডের ধরণ।

এনাম AppCommandType ।

AppCommandType এর মান নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

APP_COMMAND_TYPE_UNSPECIFIED ডিফল্ট মান। অনির্দিষ্ট।
SLASH_COMMAND একজন ব্যবহারকারী স্ল্যাশ / দিয়ে শুরু হওয়া একটি বার্তা পাঠিয়ে কমান্ডটি ব্যবহার করেন।
QUICK_COMMAND ব্যবহারকারী বার্তার উত্তরের ক্ষেত্রের চ্যাট মেনু থেকে কমান্ডটি নির্বাচন করেন।

ক্যালেন্ডার ইভেন্ট অবজেক্ট

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

নিম্নলিখিত টেবিলে একটি ইভেন্ট অবজেক্টের calendarEventObject ফিল্ডে উপস্থিত ক্ষেত্রগুলি তালিকাভুক্ত করা হয়েছে। ব্যবহারকারী-উত্পাদিত ডেটা হিসাবে চিহ্নিত ক্ষেত্রগুলি ইভেন্ট অবজেক্টে উপস্থিত থাকে যদি এবং শুধুমাত্র যদি ডেটা ক্যালেন্ডার ইভেন্টে উপস্থিত থাকে এবং অ্যাড-অন তার addOns.calendar.currentEventAccess ম্যানিফেস্ট ফিল্ডটিকে READ অথবা READ_WRITE এ সেট করে।

ক্যালেন্ডার ইভেন্ট অবজেক্ট
calendar.attendees[] list of attendee objects
ব্যবহারকারী-উত্পাদিত ডেটা। ক্যালেন্ডার ইভেন্টে অংশগ্রহণকারীদের একটি তালিকা।
calendar.calendarId string
ক্যালেন্ডার আইডি।
calendar.capabilities object
ব্যবহারকারী-উত্পাদিত ডেটা। ইভেন্ট তথ্য দেখার বা আপডেট করার জন্য অ্যাড-অনের ক্ষমতা বর্ণনা করে এমন একটি বস্তু।
calendar.capabilities.canAddAttendees boolean
ব্যবহারকারী-উত্পাদিত ডেটা। যদি অ্যাড-অন ইভেন্টের অংশগ্রহণকারীদের তালিকায় নতুন অংশগ্রহণকারীদের যোগ করতে পারে তবে true ; অন্যথায় এটি false ।
calendar.capabilities.canSeeAttendees boolean
ব্যবহারকারী-উত্পাদিত ডেটা। যদি অ্যাড-অন ইভেন্টে অংশগ্রহণকারীদের তালিকা পড়তে পারে তবে true ; অন্যথায় false ।
calendar.capabilities.canSeeConferenceData boolean
ব্যবহারকারী-উত্পাদিত ডেটা। অ্যাড-অন ইভেন্ট কনফারেন্স ডেটা পড়তে পারলে true ; অন্যথায় false ।
calendar.capabilities.canSetConferenceData boolean
ব্যবহারকারী-উত্পাদিত ডেটা। অ্যাড-অন ইভেন্ট কনফারেন্স ডেটা আপডেট করতে পারলে true ; অন্যথায় false ।
calendar.capabilities.canAddAttachments boolean
ব্যবহারকারী-উত্পাদিত ডেটা। যদি অ্যাড-অন ইভেন্টে নতুন সংযুক্তি যোগ করতে পারে তবে true ; অন্যথায় false ।
calendar.conferenceData Conference data object
ব্যবহারকারীর তৈরি ডেটা। এই ইভেন্টের সাথে সম্পর্কিত যেকোনো কনফারেন্স ডেটা, যেমন Google Meet কনফারেন্সের বিবরণ, উপস্থাপন করে এমন একটি অবজেক্ট।
calendar.id string
ইভেন্ট আইডি।
calendar.organizer object
ইভেন্টের আয়োজককে প্রতিনিধিত্বকারী একটি বস্তু।
calendar.organizer.email string
ইভেন্ট আয়োজকের ইমেল ঠিকানা।
calendar.recurringEventId string
একটি পুনরাবৃত্ত ইভেন্টের আইডি।

অংশগ্রহণকারী

অংশগ্রহণকারী অবজেক্টগুলি Google ক্যালেন্ডার ইভেন্টগুলিতে পৃথক অংশগ্রহণকারীদের সম্পর্কে তথ্য বহন করে। এই তথ্য ইভেন্ট অবজেক্টে উপস্থিত থাকে যদি এবং শুধুমাত্র যদি ডেটা ক্যালেন্ডার ইভেন্টে উপস্থিত থাকে এবং অ্যাড-অন তার addOns.calendar.currentEventAccess ম্যানিফেস্ট ফিল্ডটিকে READ অথবা READ_WRITE এ সেট করে।

অংশগ্রহণকারী বস্তু
attendee.additionalGuests number
অংশগ্রহণকারী যে অতিরিক্ত অতিথিদের আনতে চলেছেন তার সংখ্যা। ডিফল্টভাবে শূন্য।
attendee.comment string
অংশগ্রহণকারীর প্রতিক্রিয়া মন্তব্য, যদি থাকে।
attendee.displayName string
অংশগ্রহণকারীর নাম দেখানো হয়েছে।
attendee.email string
অংশগ্রহণকারীর ইমেল ঠিকানা।
attendee.optional boolean
এই অংশগ্রহণকারীর উপস্থিতি ঐচ্ছিক হিসেবে চিহ্নিত হলে true ; অন্যথায় false ।
attendee.organizer boolean
যদি অংশগ্রহণকারী এই অনুষ্ঠানের একজন সংগঠক হন তবে true ।
attendee.resource boolean
যদি অংশগ্রহণকারী কোনও সম্পদের প্রতিনিধিত্ব করেন, যেমন ঘর বা সরঞ্জাম, তাহলে true ; অন্যথায় false ।
attendee.responseStatus string
অংশগ্রহণকারীর প্রতিক্রিয়ার অবস্থা। সম্ভাব্য মানগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
  • accepted : অংশগ্রহণকারী অনুষ্ঠানের আমন্ত্রণ গ্রহণ করেছেন।
  • declined : অংশগ্রহণকারী অনুষ্ঠানের আমন্ত্রণ প্রত্যাখ্যান করেছেন।
  • needsAction : অংশগ্রহণকারী অনুষ্ঠানের আমন্ত্রণে সাড়া দেননি।
  • tentative : অংশগ্রহণকারী আপাতত অনুষ্ঠানের আমন্ত্রণ গ্রহণ করেছেন।
attendee.self boolean
যদি এই অংশগ্রহণকারী সেই ক্যালেন্ডারের প্রতিনিধিত্ব করে যেখানে এই ইভেন্টটি প্রদর্শিত হয়, তাহলে true ; অন্যথায় false ।

কনফারেন্স ডেটা

কনফারেন্স ডেটা অবজেক্টগুলি গুগল ক্যালেন্ডার ইভেন্টের সাথে সংযুক্ত কনফারেন্স সম্পর্কে তথ্য বহন করে। এগুলি গুগল কনফারেন্স সলিউশন হতে পারে, যেমন গুগল মিট, অথবা তৃতীয় পক্ষের কনফারেন্স। এই তথ্য ইভেন্ট অবজেক্টে উপস্থিত থাকে যদি এবং শুধুমাত্র যদি ডেটা ক্যালেন্ডার ইভেন্টে উপস্থিত থাকে এবং অ্যাড-অন তার addOns.calendar.currentEventAccess ম্যানিফেস্ট ফিল্ডটিকে READ অথবা READ_WRITE এ সেট করে।

কনফারেন্স ডেটা অবজেক্ট
conferenceData.conferenceId string
কনফারেন্সের আইডি। এই আইডিটি অ্যাপ্লিকেশনগুলিকে কনফারেন্সের ট্র্যাক রাখার অনুমতি দেওয়ার জন্য তৈরি করা হয়েছে; আপনার ব্যবহারকারীদের কাছে এই আইডিটি প্রদর্শন করা উচিত নয়।
conferenceData.conferenceSolution object
Hangouts বা Google Meet-এর মতো কনফারেন্স সমাধানের প্রতিনিধিত্বকারী একটি বস্তু।
conferenceData.conferenceSolution.iconUri string
এই কনফারেন্স সমাধানের প্রতিনিধিত্বকারী ব্যবহারকারী-দৃশ্যমান আইকনের URI।
conferenceData.conferenceSolution.key object
এই ইভেন্টের জন্য কনফারেন্স সমাধানকে অনন্যভাবে চিহ্নিত করার কী।
conferenceData.conferenceSolution.key.type string
কনফারেন্স সমাধানের ধরণ। সম্ভাব্য মানগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
  • গ্রাহকদের জন্য Hangouts-এর জন্য eventHangout (http://hangouts.google.com)।
  • গুগল ওয়ার্কস্পেস ব্যবহারকারীদের জন্য ক্লাসিক Hangouts-এর জন্য eventNamedHangout (http://hangouts.google.com)।
  • hangoutsMeet for Google Meet (http://meet.google.com)।
conferenceData.conferenceSolution.name string
এই কনফারেন্স সলিউশনের ব্যবহারকারী-দৃশ্যমান নাম (স্থানীয় নয়)।
conferenceData.entryPoints[] list of entry point objects
কনফারেন্স এন্ট্রি পয়েন্টের তালিকা, যেমন URL বা ফোন নম্বর।
conferenceData.notes string
ব্যবহারকারীকে প্রদর্শনের জন্য কনফারেন্স সম্পর্কে অতিরিক্ত নোট (যেমন ডোমেন প্রশাসকের নির্দেশাবলী বা আইনি নোটিশ)। HTML থাকতে পারে। সর্বোচ্চ দৈর্ঘ্য ২০৪৮ অক্ষর।
conferenceData.parameters object
অ্যাড-অন দ্বারা ব্যবহারের জন্য নির্ধারিত প্যারামিটার ডেটার একটি মানচিত্র ধারণকারী একটি অবজেক্ট।
conferenceData.parameters.addOnParameters object
প্যারামিটার স্ট্রিং কী এবং মানগুলির একটি মানচিত্র। এই কী এবং মানগুলি অ্যাড-অন ডেভেলপার দ্বারা সংজ্ঞায়িত করা হয় অ্যাড-অনের ব্যবহারের জন্য একটি নির্দিষ্ট সম্মেলনে তথ্য সংযুক্ত করার জন্য।

প্রবেশ বিন্দু

এন্ট্রি পয়েন্ট অবজেক্টগুলি কোনও নির্দিষ্ট কনফারেন্স অ্যাক্সেস করার প্রতিষ্ঠিত উপায় সম্পর্কে তথ্য বহন করে, যেমন ফোন বা ভিডিওর মাধ্যমে। এই তথ্য ইভেন্ট অবজেক্টে উপস্থিত থাকে যদি এবং শুধুমাত্র যদি ডেটা ক্যালেন্ডার ইভেন্টে উপস্থিত থাকে এবং অ্যাড-অন তার addOns.calendar.currentEventAccess ম্যানিফেস্ট ফিল্ডটিকে READ অথবা READ_WRITE এ সেট করে।

এন্ট্রি পয়েন্ট অবজেক্ট
entryPoint.accessCode string
কনফারেন্সে অ্যাক্সেস করার জন্য ব্যবহৃত অ্যাক্সেস কোড। সর্বোচ্চ দৈর্ঘ্য ১২৮ অক্ষর। কনফারেন্সে অ্যাক্সেস প্রদানের জন্য কনফারেন্স প্রদানকারীরা সাধারণত শুধুমাত্র { accessCode , meetingCode , passcode , password , pin } এর একটি উপসেট ব্যবহার করে। কনফারেন্স প্রদানকারী যে ক্ষেত্রগুলি ব্যবহার করে সেগুলি মেলান এবং শুধুমাত্র প্রদর্শন করুন।
entryPoint.entryPointFeatures list
এন্ট্রি পয়েন্টের বৈশিষ্ট্য। বর্তমানে এই বৈশিষ্ট্যগুলি শুধুমাত্র phone এন্ট্রি পয়েন্টগুলিতে প্রযোজ্য:
  • toll : প্রবেশের স্থান হল একটি টোল ফোন কল।
  • toll_free : প্রবেশপথ হল একটি টোল-মুক্ত ফোন কল।
entryPoint.entryPointType string
প্রবেশ বিন্দুর ধরণ। সম্ভাব্য মানগুলি নিম্নরূপ:
  • more : কনফারেন্সে যোগদানের জন্য অতিরিক্ত নির্দেশাবলী, যেমন বিকল্প ফোন নম্বর। একটি কনফারেন্সে কেবল more একটি প্রবেশ বিন্দু থাকতে পারে; যদি থাকে তবে কমপক্ষে অন্য একটি ধরণের প্রবেশ বিন্দুও প্রয়োজন।
  • phone : একটি ফোন নম্বরের মাধ্যমে কনফারেন্সে যোগদান করুন। একটি কনফারেন্সে শূন্য বা তার বেশি phone এন্ট্রি পয়েন্ট থাকতে পারে। বর্ণানুক্রমিকভাবে ফর্ম্যাট এবং সাজানোর পরে গুগল ক্যালেন্ডার শুধুমাত্র প্রথম দুটি ফোন এন্ট্রি পয়েন্ট প্রদর্শন করে।
  • sip : SIP এর মাধ্যমে সম্মেলনে যোগদান করুন। একটি সম্মেলনে সর্বাধিক একটি sip এন্ট্রি পয়েন্ট থাকতে পারে।
  • video : HTTP এর মাধ্যমে কনফারেন্সে যোগদান করুন। একটি কনফারেন্সে সর্বাধিক একটি video এন্ট্রি পয়েন্ট থাকতে পারে।
entryPoint.label string
এন্ট্রি পয়েন্ট URI-এর জন্য ব্যবহারকারী-দৃশ্যমান লেবেল (স্থানীয় নয়)।
entryPoint.meetingCode string
কনফারেন্স অ্যাক্সেস করার জন্য ব্যবহৃত মিটিং কোড। সর্বোচ্চ দৈর্ঘ্য ১২৮ অক্ষর। কনফারেন্সে অ্যাক্সেস প্রদানের জন্য কনফারেন্স প্রদানকারীরা সাধারণত শুধুমাত্র { accessCode , meetingCode , passcode , password , pin } এর একটি উপসেট ব্যবহার করে। কনফারেন্স প্রদানকারী যে ক্ষেত্রগুলি ব্যবহার করে সেগুলি মেলান এবং শুধুমাত্র প্রদর্শন করুন।
entryPoint.passcode string
কনফারেন্স অ্যাক্সেস করার জন্য ব্যবহৃত পাসকোড। সর্বোচ্চ দৈর্ঘ্য ১২৮ অক্ষর। কনফারেন্সে অ্যাক্সেস প্রদানের জন্য কনফারেন্স প্রদানকারীরা সাধারণত শুধুমাত্র { accessCode , meetingCode , passcode , password , pin } এর একটি উপসেট ব্যবহার করে। কনফারেন্স প্রদানকারী যে ক্ষেত্রগুলি ব্যবহার করে সেগুলি মেলান এবং শুধুমাত্র প্রদর্শন করুন।
entryPoint.password string
কনফারেন্সে প্রবেশের জন্য ব্যবহৃত পাসওয়ার্ড। সর্বোচ্চ দৈর্ঘ্য ১২৮ অক্ষর। কনফারেন্সে প্রবেশের জন্য কনফারেন্স প্রদানকারীরা সাধারণত শুধুমাত্র { accessCode , meetingCode , passcode , password , pin } এর একটি উপসেট ব্যবহার করে। কনফারেন্স প্রদানকারী যে ক্ষেত্রগুলি ব্যবহার করে সেগুলি মেলান এবং শুধুমাত্র প্রদর্শন করুন।
entryPoint.pin string
কনফারেন্স অ্যাক্সেস করার জন্য ব্যবহৃত পিন। সর্বোচ্চ দৈর্ঘ্য ১২৮ অক্ষর। কনফারেন্সে অ্যাক্সেস প্রদানের জন্য কনফারেন্স প্রদানকারীরা সাধারণত শুধুমাত্র { accessCode , meetingCode , passcode , password , pin } এর একটি উপসেট ব্যবহার করে। কনফারেন্স প্রদানকারী যে ক্ষেত্রগুলি ব্যবহার করে সেগুলি মেলান এবং শুধুমাত্র প্রদর্শন করুন।
entryPoint.regionCode string
ফোন নম্বরের আঞ্চলিক কোড। যদি URI তে দেশের কোড না থাকে তাহলে ব্যবহারকারীদের জন্য এটি প্রয়োজন। মানগুলি আঞ্চলিক কোডের পাবলিক CLDR তালিকার উপর ভিত্তি করে।
entryPoint.uri string
এন্ট্রি পয়েন্টের URI। সর্বোচ্চ দৈর্ঘ্য ১৩০০ অক্ষর। বিন্যাস এন্ট্রি পয়েন্টের ধরণের উপর নির্ভর করে:
  • more : একটি http: অথবা https: স্কিমা প্রয়োজন।
  • phone : একটি tel: স্কিমা প্রয়োজন। URI-তে সম্পূর্ণ ডায়াল সিকোয়েন্স অন্তর্ভুক্ত করা উচিত (উদাহরণস্বরূপ, "tel:+12345678900,,,12345678;1234")।
  • sip : একটি sip: অথবা sips: স্কিমা প্রয়োজন। উদাহরণস্বরূপ "sip:12345678@myprovider.com"।
  • video : একটি http: অথবা https: স্কিমা প্রয়োজন।

ড্রাইভ ইভেন্ট অবজেক্ট

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

ড্রাইভ ইভেন্ট অবজেক্ট
drive.activeCursorItem Drive item object
ড্রাইভ আইটেমটি বর্তমানে সক্রিয়।
drive.selectedItems[] list of Drive item objects
ড্রাইভে নির্বাচিত আইটেমগুলির (ফাইল বা ফোল্ডার) একটি তালিকা।

ড্রাইভ আইটেম

ড্রাইভ আইটেম অবজেক্টগুলি নির্দিষ্ট ড্রাইভ আইটেম, যেমন ফাইল বা ফোল্ডার সম্পর্কে তথ্য বহন করে।

ড্রাইভ আইটেম অবজেক্ট
item.addonHasFileScopePermission boolean
যদি true , তাহলে অ্যাড-অনটি এই আইটেমটির জন্য https://www.googleapis.com/auth/drive.file স্কোপ অনুমোদনের অনুরোধ করেছে এবং পেয়েছে; অন্যথায় এই ক্ষেত্রটি false ।
item.id string
নির্বাচিত আইটেমের আইডি।
item.iconUrl string
নির্বাচিত আইটেমটি প্রতিনিধিত্ব করে এমন আইকনের URL।
item.mimeType string
নির্বাচিত আইটেমের MIME প্রকার।
item.title string
নির্বাচিত আইটেমের শিরোনাম।

জিমেইল ইভেন্ট অবজেক্ট

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

জিমেইল ইভেন্ট অবজেক্ট
gmail.accessToken string
জিমেইল-নির্দিষ্ট অ্যাক্সেস টোকেন। আপনি এই টোকেনটি GmailApp.setCurrentMessageAccessToken(accessToken) পদ্ধতির সাহায্যে আপনার অ্যাড-অনকে ব্যবহারকারীর বর্তমানে খোলা জিমেইল বার্তায় অস্থায়ী অ্যাক্সেস দিতে পারেন অথবা আপনার অ্যাড-অনকে নতুন ড্রাফ্ট রচনা করতে দিতে পারেন।
gmail.bccRecipients[] list of strings
ডিফল্টরূপে অক্ষম । "BCC:" প্রাপক ইমেল ঠিকানাগুলির তালিকা বর্তমানে অ্যাড-অনটি তৈরি করছে এমন একটি খসড়ায় অন্তর্ভুক্ত। এই ক্ষেত্রটি চালু করতে, আপনাকে আপনার ম্যানিফেস্টে addOns.gmail.composeTrigger.draftAccess ক্ষেত্রটি METADATA তে সেট করতে হবে।
gmail.ccRecipients[] list of strings
ডিফল্টরূপে অক্ষম । অ্যাড-অনটি যে খসড়াটি তৈরি করছে তাতে বর্তমানে "CC:" প্রাপক ইমেল ঠিকানাগুলির তালিকা অন্তর্ভুক্ত রয়েছে। এই ক্ষেত্রটি চালু করতে, আপনাকে আপনার ম্যানিফেস্টে addOns.gmail.composeTrigger.draftAccess ক্ষেত্রটি METADATA তে সেট করতে হবে।
gmail.messageId string
বর্তমানে খোলা Gmail বার্তার আইডি।
gmail.threadId string
বর্তমানে খোলা জিমেইল থ্রেড আইডি।
gmail.toRecipients[] list of strings
ডিফল্টরূপে অক্ষম । অ্যাড-অনটি যে খসড়াটি তৈরি করছে তাতে বর্তমানে "প্রতি:" প্রাপক ইমেল ঠিকানাগুলির তালিকা অন্তর্ভুক্ত রয়েছে। এই ক্ষেত্রটি চালু করতে, আপনাকে আপনার ম্যানিফেস্টে addOns.gmail.composeTrigger.draftAccess ক্ষেত্রটি METADATA তে সেট করতে হবে।

ডক্স ইভেন্ট অবজেক্ট

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

ডক্স ইভেন্ট অবজেক্ট
docs.id string
শুধুমাত্র তখনই উপস্থাপন করুন যদি https://www.googleapis.com/auth/drive.file স্কোপ ব্যবহারকারী দ্বারা অনুমোদিত হয়ে থাকে ।
ডকুমেন্টের আইডিটি ডক্স UI-তে খোলা থাকে।
docs.title string
শুধুমাত্র তখনই উপস্থাপন করুন যদি https://www.googleapis.com/auth/drive.file স্কোপ ব্যবহারকারী দ্বারা অনুমোদিত হয়ে থাকে ।
ডকুমেন্টের শিরোনাম ডক্স UI-তে খোলা হবে।
docs.addonHasFileScopePermission boolean
যদি true , তাহলে অ্যাড-অনটি ডক্স UI-তে খোলা ডকুমেন্টের জন্য https://www.googleapis.com/auth/drive.file স্কোপ অনুমোদনের অনুরোধ করেছে এবং পেয়েছে; অন্যথায় এই ক্ষেত্রটি false ।
docs.matchedUrl.url string
নিম্নলিখিত শর্তগুলি পূরণ হলেই কেবল উপস্থিত থাকুন:
  • https://www.googleapis.com/auth/workspace.linkpreview ব্যবহারকারী কর্তৃক অনুমোদিত।
  • URLটি LinkPreviewTriggers ট্রিগারে উল্লেখিত হোস্ট প্যাটার্নের সাথে মেলে।

Google Docs-এ প্রিভিউ তৈরি করে এমন লিঙ্কের URL। এই ফিল্ডটি ব্যবহার করার জন্য, আপনাকে আপনার অ্যাড-অনের ম্যানিফেস্টে LinkPreviewTriggers কনফিগার করতে হবে। আরও বিস্তারিত জানার জন্য স্মার্ট চিপ সহ প্রিভিউ লিঙ্কগুলি দেখুন।

যখন একজন ব্যবহারকারী https://www.example.com/12345 লিঙ্কটি প্রিভিউ করেন তখন পেলোডের উদাহরণ:

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

পত্রক ইভেন্ট অবজেক্ট

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

পত্রক ইভেন্ট অবজেক্ট
sheets.id string
https://www.googleapis.com/auth/drive.file স্কোপ ব্যবহারকারী কর্তৃক অনুমোদিত হলেই কেবল উপস্থাপন করুন । শীট UI-তে খোলা স্প্রেডশিটের আইডি।
sheets.title string
https://www.googleapis.com/auth/drive.file স্কোপ ব্যবহারকারী কর্তৃক অনুমোদিত হলেই কেবল এটি উপস্থাপন করুন । স্প্রেডশিটের শিরোনামটি Sheets UI-তে খোলা থাকে।
sheets.addonHasFileScopePermission boolean
যদি true , তাহলে অ্যাড-অনটি শীট UI-তে খোলা স্প্রেডশিটের জন্য https://www.googleapis.com/auth/drive.file স্কোপ অনুমোদনের অনুরোধ করেছে এবং পেয়েছে; অন্যথায় এই ক্ষেত্রটি false ।
sheets.matchedUrl.url string
নিম্নলিখিত শর্তগুলি পূরণ হলেই কেবল উপস্থিত থাকুন:
  • https://www.googleapis.com/auth/workspace.linkpreview ব্যবহারকারী কর্তৃক অনুমোদিত।
  • URLটি LinkPreviewTriggers ট্রিগারে উল্লেখিত হোস্ট প্যাটার্নের সাথে মেলে।

Google Sheets-এ প্রিভিউ তৈরি করে এমন লিঙ্কের URL। এই ফিল্ডটি ব্যবহার করার জন্য, আপনাকে আপনার অ্যাড-অনের ম্যানিফেস্টে LinkPreviewTriggers কনফিগার করতে হবে। আরও বিস্তারিত জানার জন্য স্মার্ট চিপ সহ প্রিভিউ লিঙ্কগুলি দেখুন।

যখন একজন ব্যবহারকারী https://www.example.com/12345 লিঙ্কটি প্রিভিউ করেন তখন পেলোডের উদাহরণ:

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

Slides event object

The Slides event object is the portion of the overall event object that carries information about a user's document and its contents. It's only present in an event object if the add-on extends Google Slides.

Slides event object
slides.id string
Only present if the https://www.googleapis.com/auth/drive.file scope has been authorized by the user . The ID of the presentation open in the Slides UI.
slides.title string
Only present if the https://www.googleapis.com/auth/drive.file scope has been authorized by the user . The title of the presentation open in the Slides UI.
slides.addonHasFileScopePermission boolean
If true , the add-on has requested and received https://www.googleapis.com/auth/drive.file scope authorization for the presentation open in the Slides UI; otherwise this field is false .
slides.matchedUrl.url string
Only present if the following conditions are met:
  • https://www.googleapis.com/auth/workspace.linkpreview has been authorized by the user.
  • The URL matches the host pattern specified in the LinkPreviewTriggers trigger.

The URL of the link that generates a preview in Google Slides. To use this field, you must configure the LinkPreviewTriggers in your add-on's manifest. See Preview links with smart chips for more details.

Example payload for when a user previews the link https://www.example.com/12345 :

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