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

এই পৃষ্ঠায় Google Workspace অ্যাড-অন ইভেন্ট অবজেক্টের স্ট্রাকচার সম্পর্কে বলা হয়েছে।

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

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

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

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

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

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

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

    উইজেট অ্যাকশন থেকে তৈরি ইভেন্ট অবজেক্টে কনটেক্সচুয়াল ট্রিগার ইভেন্ট অবজেক্টে অন্তর্ভুক্ত সব ফিল্ড এবং উইজেট সংক্রান্ত তথ্য সহ ফিল্ড থাকে।

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

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

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

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

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

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

ইভেন্ট অবজেক্ট
eventObject.commonEventObject Common fields object
হোস্ট অ্যাপ্লিকেশন যাই হোক না কেন, সব ইভেন্ট অবজেক্টের জন্য সাধারণ তথ্য সহ একটি অবজেক্ট।
eventObject.calendar Calendar event object
কলিং হোস্ট Google Calendar হলে তবেই এটি দেখানো হয়। ক্যালেন্ডার এবং ইভেন্টের তথ্য সহ একটি অবজেক্ট।
eventObject.chat Chat event object
কলিং হোস্ট Google Chat হলে তবেই দেখানো হয়। Chat সংক্রান্ত তথ্য সহ অবজেক্ট।
eventObject.drive Drive event object
কলিং হোস্ট Google Drive হলে তবেই এটি দেখানো হয়। Drive সংক্রান্ত তথ্য সহ অবজেক্ট।
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 হলে তবেই দেখান। Slides-এর তথ্য সহ অবজেক্ট।
আসল Gmail অ্যাড-অন ফিল্ড
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 ব্যবহার করে কোনও অ্যাকশনে আপনি যে অতিরিক্ত প্যারামিটার প্রদান করেন।

ডেভেলপার প্রিভিউ: Google Chat অ্যাপের জন্য, মাল্টিসিলেক্ট মেনুতে ব্যবহারকারীরা যা টাইপ করেন তার উপর ভিত্তি করে আইটেম সাজেস্ট করতে, "autocomplete_widget_query" কী-এর (event.commonEventObject.parameters["autocomplete_widget_query"]) ভ্যালু ব্যবহার করুন। আপনি এই ভ্যালু ব্যবহার করে ডেটাবেস কোয়েরি করতে এবং ব্যবহারকারীরা টাইপ করার সাথে সাথে তাদের বেছে নেওয়ার মতো আইটেম সাজেস্ট করতে পারবেন। বিস্তারিত জানতে, Google Chat ব্যবহারকারীদের থেকে তথ্য সংগ্রহ ও প্রসেস করা দেখুন।
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
ব্যবহারকারীর বেছে নেওয়া সময়, মিলিসেকেন্ডে ইপক (১ জানুয়ারি ১৯৭০-এর 00:00:00 UTC) থেকে।
DateInput অবজেক্ট
dateInput.msSinceEpoch string
ব্যবহারকারীর বেছে নেওয়া সময়, মিলিসেকেন্ডে ইপক (১ জানুয়ারি ১৯৭০-এর 00:00:00 UTC) থেকে।
TimeInput অবজেক্ট
timeInput.hours number
ব্যবহারকারীর বেছে নেওয়া ঘণ্টার সংখ্যা।
timeInput.minutes number
ব্যবহারকারীর বেছে নেওয়া মিনিট নম্বর।

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

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

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

string (Timestamp format)

ইন্টার‍্যাকশনটি কখন ঘটেছে।

payload ফিল্ড একত্রিত করুন। অ্যাপ হোম ট্রিগারের জন্য (যখন কোনও ব্যবহারকারী হোম ট্যাব খোলেন), payload সেট করা হয় না এবং chat-এ chat.user ও chat.eventTime থাকে।

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

object (MessagePayload)

মেসেজ ট্রিগার থেকে Chat অ্যাপ যে পেলোড পায়।
chat.addedToSpacePayload

object (AddedToSpacePayload)

Chat অ্যাপ স্পেসে যোগ করা হয়েছে ট্রিগার থেকে যে পেলোড পায়।
chat.removedFromSpacePayload

object (RemovedFromSpacePayload)

Chat অ্যাপ স্পেস থেকে সরানো হয়েছে ট্রিগার থেকে যে পেলোড পায়।
chat.buttonClickedPayload

object (ButtonClickedPayload)

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

object (WidgetUpdatedPayload)

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

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

chat.appCommandPayload

object (AppCommandPayload)

Chat অ্যাপ থেকে কোনও ব্যবহারকারী কমান্ড ব্যবহার করলে Chat অ্যাপ যে পেলোড পায়।

পেলোড

Chat অ্যাপের সাথে ইন্টার‍্যাকশনের ধরনের উপর নির্ভর করে, ইভেন্টে এক বা একাধিক Chat API রিসোর্স সহ একটি পেলোড থাকে।

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

অ্যাডমিনিস্ট্রেটর Chat অ্যাপ ইনস্টল করলে, space.adminInstalled ফিল্ড true-এ সেট করা হয়।

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

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

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

Enum DialogEventType.

dialogEventType-এর ভ্যালু নিম্নলিখিতগুলির মধ্যে যেকোনও একটি হতে পারে:
TYPE_UNSPECIFIED ডিফল্ট ভ্যালু। অনির্দিষ্ট।
REQUEST_DIALOG ব্যবহারকারী একটি ডায়ালগের অনুরোধ করেন। যেমন, তারা কোনও কমান্ড ব্যবহার করেন বা মেসেজ থেকে কোনও বোতামে ক্লিক করেন।
SUBMIT_DIALOG ব্যবহারকারী কোনও ডায়ালগের মধ্যে ইন্টার‍্যাক্টিভ এলিমেন্টে ক্লিক করেন। যেমন, কোনও ব্যবহারকারী ডায়ালগে তথ্য পূরণ করে সেটি জমা দেওয়ার জন্য বোতামে ক্লিক করেন।
উইজেট আপডেট করা পে-লোড
WidgetUpdatedPayload
chat.widgetUpdatedPayload.space object (Space)
যে Chat স্পেসে ইন্টার‍্যাকশন হয়েছে।
অ্যাপ কমান্ড পেলোড
AppCommandPayload
chat.appCommandPayload.appCommandMetadata object (AppCommandMetadata)
ব্যবহারকারী কোন কমান্ড ব্যবহার করেছেন এবং কীভাবে তা ট্রিগার করেছেন সেই সংক্রান্ত মেটাডেটা।
chat.appCommandPayload.space object (Space)
যে Chat স্পেসে কোনও ব্যবহারকারী কমান্ড ব্যবহার করেছেন।
chat.appCommandPayload.thread object (Thread)
ইন্টার‍্যাকশন কোনও থ্রেডে হয়ে থাকলে, Chat থ্রেড যেখানে ব্যবহারকারী কমান্ড ব্যবহার করেছেন।
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 ব্যবহারকারী কোনও ডায়ালগের মধ্যে ইন্টার‍্যাক্টিভ এলিমেন্টে ক্লিক করেন। যেমন, কোনও ব্যবহারকারী ডায়ালগে তথ্য পূরণ করে সেটি জমা দেওয়ার জন্য বোতামে ক্লিক করেন।
অ্যাপ কমান্ড মেটাডেটা
AppCommandMetadata
chat.appCommandPayload.appCommandMetadata.appCommandId

string (int64 format)

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

Enum AppCommandType.

AppCommandType-এর ভ্যালু নিম্নলিখিতগুলির মধ্যে যেকোনও একটি হতে পারে:
APP_COMMAND_TYPE_UNSPECIFIED ডিফল্ট ভ্যালু। অনির্দিষ্ট।
SLASH_COMMAND ব্যবহারকারী স্ল্যাশ / দিয়ে শুরু হওয়া মেসেজ পাঠিয়ে কমান্ড ব্যবহার করেন।
QUICK_COMMAND ব্যবহারকারী মেসেজের উত্তর দেওয়ার জায়গায় Chat মেনু থেকে কমান্ড বেছে নেন।

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

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

নিচের সারণীতে ইভেন্ট অবজেক্টের calendarEventObject ফিল্ডে থাকা ফিল্ডের তালিকা দেওয়া হয়েছে। ব্যবহারকারীর তৈরি করা ডেটা হিসেবে চিহ্নিত ফিল্ড ইভেন্ট অবজেক্টে তখনই থাকে যখন ডেটা Calendar ইভেন্টে থাকে এবং অ্যাড-অন তার addOns.calendar.currentEventAccess ম্যানিফেস্ট ফিল্ড READ বা READ_WRITE-এ সেট করে।

এই অবজেক্ট এবং এর সাবস্ট্রাকচারের অনেক ফিল্ডের জন্য, একই নামের Calendar API ইভেন্ট রিসোর্স ফিল্ডের সাথে সরাসরি ম্যাপিং আছে। ফিল্ডের বিবরণ আলাদা হলে, নিম্নলিখিত সারণীতে দেওয়া তথ্য সঠিক।

ক্যালেন্ডার ইভেন্ট অবজেক্ট
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 Calendar ইভেন্টে অংশগ্রহণকারী ব্যক্তিদের সম্পর্কে তথ্য থাকে। এই তথ্য ইভেন্ট অবজেক্টে তখনই থাকে যখন ডেটা Calendar ইভেন্টে থাকে এবং অ্যাড-অন তার 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।

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

কনফারেন্স ডেটা অবজেক্টে Google Calendar ইভেন্টের সাথে অ্যাটাচ করা কনফারেন্সের তথ্য থাকে। এগুলি Google Meet-এর মতো Google কনফারেন্সিং সমাধান বা থার্ড-পার্টি কনফারেন্স হতে পারে। এই তথ্য ইভেন্ট অবজেক্টে তখনই থাকে যখন ডেটা Calendar ইভেন্টে থাকে এবং অ্যাড-অন তার 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)।
  • eventNamedHangout Google Workspace ব্যবহারকারীদের জন্য ক্লাসিক Hangouts (http://hangouts.google.com)।
  • Google Meet-এর জন্য hangoutsMeet (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টি এন্ট্রি পয়েন্ট থাকতে পারে। Google Calendar শুধুমাত্র প্রথম দুটি ফোন এন্ট্রি পয়েন্ট দেখায়, যা বর্ণানুক্রমিকভাবে ফর্ম্যাট ও সাজানো হয়।
  • 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 ইভেন্ট অবজেক্ট

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

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

Drive আইটেম

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

Drive আইটেম অবজেক্ট
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 ইভেন্ট অবজেক্ট

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

Gmail ইভেন্ট অবজেক্ট
gmail.accessToken string
Gmail-নির্দিষ্ট অ্যাক্সেস টোকেন। ব্যবহারকারীর বর্তমানে খোলা Gmail মেসেজে আপনার অ্যাড-অনকে সাময়িক অ্যাক্সেস দিতে অথবা আপনার অ্যাড-অনকে নতুন ড্রাফ্ট কম্পোজ করার অনুমতি দিতে GmailApp.setCurrentMessageAccessToken পদ্ধতির সাথে এই টোকেন ব্যবহার করুন।
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 থ্রেড আইডি।
gmail.toRecipients[] list of strings
ডিফল্ট হিসেবে বন্ধ করা আছে। অ্যাড-অন কম্পোজ করছে এমন ড্রাফ্টে বর্তমানে অন্তর্ভুক্ত "প্রাপক:" ইমেল আইডির তালিকা। এই ফিল্ড চালু করতে, আপনার ম্যানিফেস্টে addOns.gmail.composeTrigger.draftAccess ফিল্ডটি METADATA-এ সেট করুন।

Docs ইভেন্ট অবজেক্ট

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

Docs ইভেন্ট অবজেক্ট
docs.id string
শুধুমাত্র তখনই উপস্থিত থাকে যখন https://www.googleapis.com/auth/drive.file স্কোপ ব্যবহারকারী দ্বারা অনুমোদিত হয়।
Docs UI-তে খোলা ডকুমেন্টের আইডি।
docs.title string
ব্যবহারকারী https://www.googleapis.com/auth/drive.file স্কোপের অনুমোদন দিলে তবেই এটি দেখানো হয়।
Docs UI-তে খোলা ডকুমেন্টের শীর্ষক।
docs.addonHasFileScopePermission boolean
true হলে, Docs 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"
  }
}

Sheets ইভেন্ট অবজেক্ট

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

Sheets ইভেন্ট অবজেক্ট
sheets.id string
ব্যবহারকারী https://www.googleapis.com/auth/drive.file স্কোপ অনুমোদন করলে তবেই এটি দেখানো হয়। Sheets UI-তে খোলা স্প্রেডশিটের আইডি।
sheets.title string
ব্যবহারকারী https://www.googleapis.com/auth/drive.file স্কোপ অনুমোদন করলে তবেই এটি দেখানো হয়। Sheets UI-তে খোলা স্প্রেডশিটের নাম।
sheets.addonHasFileScopePermission boolean
যদি true হয়, তাহলে Sheets 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 ইভেন্ট অবজেক্ট

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

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

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

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

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