ঘটনা বস্তু

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

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

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

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

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

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

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

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

    উইজেট ক্রিয়াকলাপের ফলে তৈরি ইভেন্ট অবজেক্টগুলিতে প্রাসঙ্গিক ট্রিগার ইভেন্ট অবজেক্টের অন্তর্ভুক্ত সমস্ত ক্ষেত্র এবং উইজেট তথ্য সম্বলিত ক্ষেত্র রয়েছে।

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

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

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

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

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

ইভেন্ট অবজেক্ট
eventObject.commonEventObject Common fields object
হোস্ট অ্যাপ্লিকেশন নির্বিশেষে, সমস্ত ইভেন্ট অবজেক্টের জন্য সাধারণ তথ্য ধারণকারী একটি বস্তু।
eventObject.calendar Calendar event object
কলিং হোস্ট যদি Google ক্যালেন্ডার হয় শুধুমাত্র তাহলেই উপস্থিত । ক্যালেন্ডার এবং ইভেন্টের তথ্য ধারণকারী একটি বস্তু।
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 ডক্স হয় তবেই কেবল উপস্থিত । ডক্স তথ্য ধারণকারী একটি বস্তু.
eventObject.sheets Sheets event object
কলিং হোস্ট যদি Google পত্রক হয় শুধুমাত্র তাহলেই উপস্থিত । পত্রক তথ্য ধারণকারী একটি বস্তু।
eventObject.slides Slides event object
কলিং হোস্ট যদি Google স্লাইড হয় তবেই উপস্থিত । স্লাইড তথ্য ধারণকারী একটি বস্তু.
আসল জিমেইল অ্যাড-অন ক্ষেত্র
eventObject.messageMetadata.accessToken string
অবচয়। একটি অ্যাক্সেস টোকেন। আপনি অস্থায়ী Gmail অ্যাড-অন স্কোপ ব্যবহার করে ব্যবহারকারীর ডেটাতে অ্যাক্সেস চালু করতে এটি ব্যবহার করতে পারেন।

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

eventObject.messageMetadata.messageId string
অবচয়। থ্রেডের মেসেজ আইডি জিমেইল 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 চ্যাটকে প্রসারিত করে , ব্যবহারকারীরা মাল্টিসিলেক্ট মেনুতে যা টাইপ করে তার উপর ভিত্তি করে আইটেমগুলি সাজেস্ট করতে, "autocomplete_widget_query" কী ( event.commonEventObject.parameters["autocomplete_widget_query"] ) এর মান ব্যবহার করুন। আপনি একটি ডাটাবেস অনুসন্ধান করতে এই মানটি ব্যবহার করতে পারেন এবং ব্যবহারকারীদের টাইপ করার সাথে সাথে নির্বাচনযোগ্য আইটেমগুলির পরামর্শ দিতে পারেন। বিশদ বিবরণের জন্য, Google চ্যাট ব্যবহারকারীদের কাছ থেকে তথ্য সংগ্রহ এবং প্রক্রিয়া করুন দেখুন।

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 1 জানুয়ারী 1970)।
DateInput অবজেক্ট
dateInput.msSinceEpoch string
ব্যবহারকারীর দ্বারা নির্বাচিত সময়, যুগ থেকে মিলিসেকেন্ডে (00:00:00 UTC 1 জানুয়ারী 1970)।
TimeInput অবজেক্ট
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 )

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

chat.buttonClickedPayload

object ( ButtonClickedPayload )

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

chat.widgetUpdatedPayload

object ( WidgetUpdatedPayload )

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

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

chat.appCommandPayload

object ( AppCommandPayload )

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

পেলোড

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

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

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

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

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

স্থান পেলোড থেকে সরানো হয়েছে
SpacePayload থেকে সরানো হয়েছে
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 একজন ব্যবহারকারী একটি ডায়ালগের মধ্যে একটি ইন্টারেক্টিভ উপাদান ক্লিক করে। উদাহরণস্বরূপ, একজন ব্যবহারকারী একটি ডায়ালগে তথ্য পূরণ করে এবং তথ্য জমা দিতে একটি বোতামে ক্লিক করে।

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

অ্যাপ কমান্ড পেলোড
AppCommandPayload
chat.appCommandPayload.appCommandMetadata object ( AppCommandMetadata )
ব্যবহারকারী কোন কমান্ড ব্যবহার করেছেন এবং কিভাবে তারা কমান্ডটি ট্রিগার করেছে সে সম্পর্কে মেটাডেটা।
chat.appCommandPayload.space object ( Space )
চ্যাট স্পেস যেখানে একজন ব্যবহারকারী কমান্ড ব্যবহার করেছেন।
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 ব্যবহারকারী বার্তা উত্তর এলাকায় চ্যাট মেনু থেকে কমান্ড নির্বাচন করে।

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

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

নিম্নলিখিত টেবিলটি একটি ইভেন্ট অবজেক্টের 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 ।

সম্মেলনের তথ্য

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

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

এন্ট্রি পয়েন্ট

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

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

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

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

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

জিমেইল ইভেন্ট অবজেক্ট
gmail.accessToken string
Gmail-নির্দিষ্ট অ্যাক্সেস টোকেন। আপনি GmailApp.setCurrentMessageAccessToken(accessToken) পদ্ধতির সাথে এই টোকেনটি ব্যবহার করতে পারেন আপনার অ্যাড-অনকে একটি ব্যবহারকারীর বর্তমানে খোলা 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 সেট করতে হবে।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

লিঙ্কটির ইউআরএল যা গুগল স্লাইডগুলিতে একটি পূর্বরূপ উত্পন্ন করে। এই ক্ষেত্রটি ব্যবহার করতে, আপনাকে অবশ্যই আপনার অ্যাড-অনের ম্যানিফেস্টে LinkPreviewTriggers কনফিগার করতে হবে। আরও তথ্যের জন্য স্মার্ট চিপগুলির সাথে পূর্বরূপ লিঙ্কগুলি দেখুন।

উদাহরণস্বরূপ পে -লোড যখন কোনও ব্যবহারকারী লিঙ্কটির পূর্বরূপ দেয় https://www.example.com/12345 :

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