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

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

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

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

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

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

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

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

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

    উইজেট অ্যাকশন থেকে তৈরি ইভেন্ট অবজেক্টে প্রাসঙ্গিক ট্রিগার ইভেন্ট অবজেক্টে অন্তর্ভুক্ত সব ফিল্ডের সাথে উইজেট সংক্রান্ত তথ্য থাকা ফিল্ডও থাকে।

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

  • Google Chat অ্যাপ ট্রিগার। Google 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 হলে তবেই উপস্থিত থাকে। চ্যাট সংক্রান্ত তথ্য থাকা একটি অবজেক্ট।
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 ব্যবহার করে Action.setParameters-এ আপনার দেওয়া অতিরিক্ত প্যারামিটারের ম্যাপ। ম্যাপের কী ও ভ্যালু হল স্ট্রিং।

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

eventObject.userCountry string
পুরনো হয়ে গেছে এবং ডিফল্ট হিসেবে বন্ধ করা আছে। ব্যবহারকারীর দেশ বা অঞ্চল নির্দেশ করে এমন দুটি অক্ষরের কোড। এছাড়াও এটি একটি সংখ্যাসূচক জাতিসংঘের 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
দেখানো কার্ডে উইজেটের বর্তমান ভ্যালু সহ ম্যাপ। ম্যাপ কী হল স্ট্রিং আইডি যা প্রতিটি উইজেটের সাথে অ্যাসাইন করা হয়।

ম্যাপ ভ্যালু অবজেক্টের স্ট্রাকচার উইজেটের ধরনের উপর নির্ভর করে:

  • সিঙ্গেল-ভ্যালু উইজেট (যেমন, টেক্সট বক্স): স্ট্রিংয়ের তালিকা (শুধুমাত্র একটি এলিমেন্ট)।

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

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

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

  • A date-time picker: ক DateTimeInput object.

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

  • A date-only picker: a DateInput object.

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

  • A time-only picker: ক TimeInput object.

    উদাহরণ: myTimePicker আইডি সহ পিকারের জন্য, TimeInput অবজেক্টটি e.commonEventObject.formInputs.myTimePicker.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 to 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 অবজেক্ট
dateInput.msSinceEpoch string
ব্যবহারকারীর বেছে নেওয়া সময়, মিলিসেকেন্ডে ইপক (১ জানুয়ারি, ১৯৭০-এ ০০:০০:০০ UTC) থেকে।
TimeInput অবজেক্ট
timeInput.hours number
ব্যবহারকারীর বেছে নেওয়া ঘণ্টার নম্বর।
timeInput.minutes number
ব্যবহারকারীর বেছে নেওয়া মিনিটের সংখ্যা।

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

চ্যাট ইভেন্ট অবজেক্ট হল সামগ্রিক ইভেন্ট অবজেক্টের সেই অংশ যা কোনও ব্যবহারকারীর সাথে চ্যাট অ্যাপের ইন্টার‍্যাকশন সংক্রান্ত তথ্য বহন করে। এটি শুধুমাত্র তখনই কোনও ইভেন্ট অবজেক্টে থাকে যখন অ্যাড-অন 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 অ্যাপ যে পেলোড পায়। ডায়নামিক ডেটা সোর্স থেকে সাজেস্ট করা আইটেম পূরণ করতে চ্যাট অ্যাপ এই ইভেন্ট অবজেক্ট ব্যবহার করতে পারে। যেমন, এক্সটার্নাল ডেটা সোর্স থেকে সহায়তা সংক্রান্ত কেস পূরণ করতে, কোনও চ্যাট অ্যাপ, ব্যবহারকারী মেনুতে যা টাইপ করেন তার ভিত্তিতে ডেটা সোর্স কোয়েরি করতে পারে এবং তারপরে বেছে নেওয়ার মতো আইটেম হিসেবে ম্যাচ করা সহায়তা সংক্রান্ত কেস রিটার্ন করতে পারে।

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

chat.appCommandPayload

object (AppCommandPayload)

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

পেলোড

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

মেসেজ পেলোড
MessagePayload
chat.messagePayload.message object (Message)
চ্যাট মেসেজ যা ইভেন্ট ট্রিগার করেছে।
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)
যে চ্যাট স্পেসে ইন্টার‍্যাকশন হয়েছে।
অ্যাপ কমান্ড পেলোড
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 মেনু থেকে কমান্ড বেছে নেন।

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

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