এই পৃষ্ঠাটি Google Workspace অ্যাড-অন ইভেন্ট অবজেক্টের কাঠামোর রূপরেখা দেয়।
ইভেন্ট অবজেক্ট হল JSON স্ট্রাকচার যা স্বয়ংক্রিয়ভাবে তৈরি হয় এবং প্যারামিটার হিসেবে ট্রিগার বা কলব্যাক ফাংশন হিসেবে পাস করা হয় যখন একজন ব্যবহারকারী অ্যাড-অনের সাথে ইন্টারঅ্যাক্ট করে। ইভেন্ট অবজেক্টগুলি হোস্ট অ্যাপ সম্পর্কে ক্লায়েন্ট-সাইড তথ্য এবং অ্যাড-অনের সার্ভার-সাইড কলব্যাক ফাংশনের বর্তমান প্রসঙ্গ বহন করে।
Google Workspace অ্যাড-অন নিম্নলিখিত জায়গায় ইভেন্ট অবজেক্ট ব্যবহার করে:
হোমপেজ ট্রিগার আপনার সংজ্ঞায়িত প্রতিটি
homepageTrigger
ফাংশন স্বয়ংক্রিয়ভাবে একটি ইভেন্ট অবজেক্ট পাস করা হয় যখন হোমপেজ ট্রিগার ফাংশন ফায়ার হয়। সক্রিয় হোস্ট অ্যাপ, ক্লায়েন্টের প্ল্যাটফর্ম, ব্যবহারকারীর লোকেল এবং অন্যান্য তথ্য সনাক্ত করতে আপনি আপনার হোমপেজ ট্রিগার ফাংশনে এই বস্তুটি ব্যবহার করতে পারেন।হোমপেজে আগুন ট্রিগার করার সময় যে ইভেন্ট অবজেক্ট তৈরি হয় তাতে অন্য দুটি ক্ষেত্রে অন্তর্ভুক্ত সমস্ত ক্ষেত্র থাকে না; উইজেট এবং প্রাসঙ্গিক তথ্য সম্পর্কিত ক্ষেত্রগুলি বাদ দেওয়া হয়েছে।
প্রাসঙ্গিক ট্রিগার প্রতিটি হোস্ট অ্যাপ্লিকেশন প্রাসঙ্গিক ট্রিগারগুলির একটি আলাদা সেট সরবরাহ করে যা ব্যবহারকারী যখন একটি নির্দিষ্ট প্রসঙ্গে প্রবেশ করে তখন আগুন দেয়। যেমন:
- Gmail একটি প্রাসঙ্গিক ট্রিগার প্রদান করে যখন একজন ব্যবহারকারী একটি বার্তা খোলে এবং অন্যটি যখন একটি ব্যবহারকারী একটি বার্তা রচনা করে ।
- যখন একজন ব্যবহারকারী একটি ইভেন্ট খোলেন তখন Google ক্যালেন্ডার একটি প্রাসঙ্গিক ট্রিগার প্রদান করে।
- যখন একজন ব্যবহারকারী ড্রাইভ ফাইল নির্বাচন করে তখন Google ড্রাইভ একটি প্রাসঙ্গিক ট্রিগার প্রদান করে।
যখন একটি প্রাসঙ্গিক ট্রিগার ফায়ার হয়, হোস্ট অ্যাপ্লিকেশনটি অ্যাড-অন ম্যানিফেস্টে তালিকাভুক্ত সংশ্লিষ্ট
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.messageMetadata.messageId | string অবচয়। থ্রেডের মেসেজ আইডি জিমেইল UI এ খুলবে। Google Workspace অ্যাড-অনগুলির জন্য, |
eventObject.clientPlatform | string অবচয়। ইভেন্টের উৎপত্তি কোথায় তা নির্দেশ করে (ওয়েব, iOS, বা Android)। Google Workspace অ্যাড-অনগুলির জন্য, |
eventObject.formInput | object অবচয়। কার্ডের সমস্ত ফর্ম উইজেটগুলির বর্তমান মানগুলির একটি মানচিত্র, প্রতি উইজেট একটি মানের মধ্যে সীমাবদ্ধ৷ কীগুলি হল উইজেটগুলির সাথে যুক্ত স্ট্রিং আইডি এবং মানগুলি হল স্ট্রিং৷ ইভেন্ট অবজেক্ট একটি সুবিধা হিসাবে formInput প্রদান করে যখন আপনাকে প্রত্যাশিত একক মান সহ একাধিক উইজেট থেকে ডেটা পড়তে হবে, যেমন টেক্সট ইনপুট এবং সুইচ। চেকবক্সের মতো বহু-মূল্যবান উইজেটের জন্য, আপনি পরিবর্তে formInputs থেকে প্রতিটি মান পড়তে পারেন। Google Workspace অ্যাড-অনগুলির জন্য, পরিবর্তে |
eventObject.formInputs | object অবচয়। কার্ডে উইজেটগুলির বর্তমান মানগুলির একটি মানচিত্র, স্ট্রিংগুলির তালিকা হিসাবে উপস্থাপিত৷ কী হল উইজেটের সাথে যুক্ত স্ট্রিং আইডি। একক-মূল্যবান উইজেটের জন্য, মানটি একটি একক-উপাদান অ্যারেতে উপস্থাপিত হয়। চেকবক্স গ্রুপের মতো বহু-মূল্যবান উইজেটের জন্য, সমস্ত মান একটি তালিকায় উপস্থাপন করা হয়। Google Workspace অ্যাড-অনগুলির জন্য, |
eventObject.parameters | object অবচয়। Action.setParameters() ব্যবহার করে Action আপনি যে অতিরিক্ত প্যারামিটার সরবরাহ করেন তার একটি মানচিত্র। মানচিত্র কী এবং মান হল স্ট্রিং। Google Workspace অ্যাড-অনগুলির জন্য, |
eventObject.userCountry | string ডিফল্টরূপে বঞ্চিত এবং অক্ষম । ব্যবহারকারীর দেশ বা অঞ্চল নির্দেশ করে দুই-অক্ষরের কোড। এটি একটি সংখ্যাসূচক UN M49 দেশের কোডও হতে পারে। Google Workspace অ্যাড-অনগুলির জন্য, |
eventObject.userLocale | string ডিফল্টরূপে বঞ্চিত এবং অক্ষম । দুই-অক্ষরের ISO 639 কোড ব্যবহারকারীর ভাষা নির্দেশ করে। আরো বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন। Google Workspace অ্যাড-অনগুলির জন্য, |
eventObject.userTimezone.id | string ডিফল্টরূপে বঞ্চিত এবং অক্ষম । ব্যবহারকারীর টাইমজোনের টাইমজোন শনাক্তকারী । উদাহরণগুলির মধ্যে রয়েছে: America/New_York , Europe/Vienna এবং Asia/Seoul । আরো বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন। Google Workspace অ্যাড-অনগুলির জন্য, |
eventObject.userTimezone.offset | string ডিফল্টরূপে বঞ্চিত এবং অক্ষম । ব্যবহারকারীর টাইমজোনের সমন্বিত ইউনিভার্সাল টাইম (UTC) থেকে মিলিসেকেন্ডে পরিমাপ করা সময় । আরো বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন। Google Workspace অ্যাড-অনগুলির জন্য, |
সাধারণ ঘটনা অবজেক্ট
সাধারণ ইভেন্ট অবজেক্ট হল সামগ্রিক ইভেন্ট অবজেক্টের অংশ যা ব্যবহারকারীর ক্লায়েন্ট থেকে অ্যাড-অনে সাধারণ, হোস্ট-স্বাধীন তথ্য বহন করে। এই তথ্যে ব্যবহারকারীর লোকেল, হোস্ট অ্যাপ এবং প্ল্যাটফর্মের মতো বিশদ বিবরণ অন্তর্ভুক্ত রয়েছে।
হোমপেজ এবং প্রাসঙ্গিক ট্রিগার ছাড়াও, ব্যবহারকারী যখন উইজেটগুলির সাথে ইন্টারঅ্যাক্ট করে তখন অ্যাড-অনগুলি ইভেন্ট অবজেক্টকে অ্যাকশন কলব্যাক ফাংশনে পাঠায়। আপনার অ্যাড-অনের কলব্যাক ফাংশন ব্যবহারকারীর ক্লায়েন্টে খোলা উইজেটের বিষয়বস্তু নির্ধারণ করতে সাধারণ ইভেন্ট অবজেক্টকে জিজ্ঞাসা করতে পারে। উদাহরণস্বরূপ, আপনার অ্যাড-অন ইভেন্টঅবজেক্ট. eventObject.commentEventObject.formInputs
অবজেক্টে একটি TextInput
উইজেটে ব্যবহারকারীর প্রবেশ করা টেক্সটটি সনাক্ত করতে পারে।
সাধারণ ইভেন্ট অবজেক্ট ক্ষেত্র | |
---|---|
commonEventObject.platform | string ইভেন্টের উৎপত্তি কোথায় তা নির্দেশ করে (`WEB`, `IOS`, বা `ANDROID`)। |
commonEventObject.formInputs | object প্রদর্শিত কার্ডে উইজেটগুলির বর্তমান মান ধারণকারী একটি মানচিত্র। মানচিত্র কী হল প্রতিটি উইজেটের সাথে বরাদ্দ করা স্ট্রিং আইডি। মানচিত্র মান বস্তুর গঠন উইজেট ধরনের উপর নির্ভর করে: উদাহরণস্বরূপ, Apps স্ক্রিপ্টে রানটাইম সম্পর্কে আরও জানতে, V8 রানটাইম ওভারভিউ দেখুন।
|
commonEventObject.hostApp | string ইভেন্ট অবজেক্ট তৈরি হওয়ার সময় অ্যাড-অন সক্রিয় থাকা হোস্ট অ্যাপটিকে নির্দেশ করে। সম্ভাব্য মানগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
|
commonEventObject.parameters | object actionParameters বা Action.setParameters() ব্যবহার করে কোনও অ্যাকশনে আপনি যে কোনও অতিরিক্ত প্যারামিটার সরবরাহ করেন। ডেভেলপার প্রিভিউ: অ্যাড-অনগুলির জন্য যা Google চ্যাটকে প্রসারিত করে , ব্যবহারকারীরা মাল্টিসিলেক্ট মেনুতে যা টাইপ করে তার উপর ভিত্তি করে আইটেমগুলি সাজেস্ট করতে, |
commonEventObject.userLocale | string ডিফল্টরূপে অক্ষম । ISO 639 ভাষার কোড- ISO 3166 দেশ/অঞ্চল কোডের বিন্যাসে ব্যবহারকারীর ভাষা এবং দেশ/অঞ্চল সনাক্তকারী। উদাহরণস্বরূপ, en-US . এই ক্ষেত্রটি চালু করতে, আপনাকে অবশ্যই আপনার অ্যাড-অনের ম্যানিফেস্টে |
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
ক্ষেত্রের বর্তমান উইজেট মানগুলি গ্রহণ করতে পারে। এটি তারিখ বা সময় চয়নকারী উইজেটগুলিতে ব্যবহারকারীর নির্বাচিত তারিখ বা সময়ের মান অন্তর্ভুক্ত করে। যাইহোক, উইজেটটি তারিখ-সময় বাছাইকারী, একটি তারিখ-শুধু বাছাইকারী, বা শুধুমাত্র-সময় চয়নকারী হিসাবে কনফিগার করা হয়েছে কিনা তার উপর নির্ভর করে তথ্যের গঠন ভিন্ন হয়। কাঠামোগত পার্থক্য নিম্নলিখিত সারণীতে বর্ণনা করা হয়েছে:
ক্যালেন্ডার ইভেন্ট অবজেক্ট
ক্যালেন্ডার ইভেন্ট অবজেক্ট হল সামগ্রিক ইভেন্ট অবজেক্টের অংশ যা একজন ব্যবহারকারীর ক্যালেন্ডার এবং ক্যালেন্ডার ইভেন্ট সম্পর্কে তথ্য বহন করে। এটি শুধুমাত্র একটি ইভেন্ট অবজেক্টে উপস্থিত থাকে যদি হোস্ট অ্যাপ্লিকেশনটি 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 অংশগ্রহণকারীর প্রতিক্রিয়া অবস্থা. সম্ভাব্য মানগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
|
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 সম্মেলনের সমাধানের ধরন। সম্ভাব্য মানগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
|
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 এন্ট্রি পয়েন্টগুলিতে প্রযোজ্য:
|
entryPoint.entryPointType | string এন্ট্রি পয়েন্টের ধরন। সম্ভাব্য মান নিম্নরূপ:
|
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 অক্ষর। বিন্যাস এন্ট্রি পয়েন্ট ধরনের উপর নির্ভর করে:
|
ড্রাইভ ইভেন্ট অবজেক্ট
ড্রাইভ ইভেন্ট অবজেক্ট হল সামগ্রিক ইভেন্ট অবজেক্টের অংশ যা একজন ব্যবহারকারীর 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 নিম্নলিখিত শর্ত পূরণ করা হলে শুধুমাত্র উপস্থিত:
লিঙ্কের URL যা Google ডক্সে একটি পূর্বরূপ তৈরি করে। এই ক্ষেত্রটি ব্যবহার করতে, আপনাকে অবশ্যই আপনার অ্যাড-অনের ম্যানিফেস্টে LinkPreviewTriggers কনফিগার করতে হবে। আরও বিশদ বিবরণের জন্য স্মার্ট চিপগুলির সাথে প্রিভিউ লিঙ্কগুলি দেখুন৷ একজন ব্যবহারকারী যখন লিঙ্কটির পূর্বরূপ দেখেন তখন পেলোডের উদাহরণ "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 নিম্নলিখিত শর্ত পূরণ করা হলে শুধুমাত্র উপস্থিত:
লিঙ্কের URL যা Google পত্রকগুলিতে একটি পূর্বরূপ তৈরি করে৷ এই ক্ষেত্রটি ব্যবহার করতে, আপনাকে অবশ্যই আপনার অ্যাড-অনের ম্যানিফেস্টে LinkPreviewTriggers কনফিগার করতে হবে। আরও বিশদ বিবরণের জন্য স্মার্ট চিপগুলির সাথে প্রিভিউ লিঙ্কগুলি দেখুন৷ একজন ব্যবহারকারী যখন লিঙ্কটির পূর্বরূপ দেখেন তখন পেলোডের উদাহরণ "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 হলে, অ্যাড-অন স্লাইডস UI-তে খোলা উপস্থাপনার জন্য https://www.googleapis.com/auth/drive.file স্কোপের অনুমোদনের অনুরোধ করেছে এবং পেয়েছে; অন্যথায় এই ক্ষেত্রটি false । |
slides.matchedUrl.url | string নিম্নলিখিত শর্ত পূরণ করা হলে শুধুমাত্র উপস্থিত:
লিঙ্কের URL যা Google স্লাইডে একটি পূর্বরূপ তৈরি করে। এই ক্ষেত্রটি ব্যবহার করতে, আপনাকে অবশ্যই আপনার অ্যাড-অনের ম্যানিফেস্টে LinkPreviewTriggers কনফিগার করতে হবে। আরও বিশদ বিবরণের জন্য স্মার্ট চিপগুলির সাথে প্রিভিউ লিঙ্কগুলি দেখুন৷ একজন ব্যবহারকারী যখন লিঙ্কটির পূর্বরূপ দেখেন তখন পেলোডের উদাহরণ "slides" : { "matchedUrl" : { "url" : "https://www.example.com/12345" } } |
এই পৃষ্ঠাটি Google Workspace অ্যাড-অন ইভেন্ট অবজেক্টের কাঠামোর রূপরেখা দেয়।
ইভেন্ট অবজেক্ট হল JSON স্ট্রাকচার যা স্বয়ংক্রিয়ভাবে তৈরি হয় এবং প্যারামিটার হিসেবে ট্রিগার বা কলব্যাক ফাংশন হিসেবে পাস করা হয় যখন একজন ব্যবহারকারী অ্যাড-অনের সাথে ইন্টারঅ্যাক্ট করে। ইভেন্ট অবজেক্টগুলি হোস্ট অ্যাপ সম্পর্কে ক্লায়েন্ট-সাইড তথ্য এবং অ্যাড-অনের সার্ভার-সাইড কলব্যাক ফাংশনের বর্তমান প্রসঙ্গ বহন করে।
Google Workspace অ্যাড-অন নিম্নলিখিত জায়গায় ইভেন্ট অবজেক্ট ব্যবহার করে:
হোমপেজ ট্রিগার আপনার সংজ্ঞায়িত প্রতিটি
homepageTrigger
ফাংশন স্বয়ংক্রিয়ভাবে একটি ইভেন্ট অবজেক্ট পাস করা হয় যখন হোমপেজ ট্রিগার ফাংশন ফায়ার হয়। সক্রিয় হোস্ট অ্যাপ, ক্লায়েন্টের প্ল্যাটফর্ম, ব্যবহারকারীর লোকেল এবং অন্যান্য তথ্য সনাক্ত করতে আপনি আপনার হোমপেজ ট্রিগার ফাংশনে এই বস্তুটি ব্যবহার করতে পারেন।হোমপেজে আগুন ট্রিগার করার সময় যে ইভেন্ট অবজেক্ট তৈরি হয় তাতে অন্য দুটি ক্ষেত্রে অন্তর্ভুক্ত সমস্ত ক্ষেত্র থাকে না; উইজেট এবং প্রাসঙ্গিক তথ্য সম্পর্কিত ক্ষেত্রগুলি বাদ দেওয়া হয়েছে।
প্রাসঙ্গিক ট্রিগার প্রতিটি হোস্ট অ্যাপ্লিকেশন প্রাসঙ্গিক ট্রিগারগুলির একটি আলাদা সেট সরবরাহ করে যা ব্যবহারকারী যখন একটি নির্দিষ্ট প্রসঙ্গে প্রবেশ করে তখন আগুন দেয়। যেমন:
- Gmail একটি প্রাসঙ্গিক ট্রিগার প্রদান করে যখন একজন ব্যবহারকারী একটি বার্তা খোলে এবং অন্যটি যখন একটি ব্যবহারকারী একটি বার্তা রচনা করে ।
- যখন একজন ব্যবহারকারী একটি ইভেন্ট খোলেন তখন Google ক্যালেন্ডার একটি প্রাসঙ্গিক ট্রিগার প্রদান করে।
- যখন একজন ব্যবহারকারী ড্রাইভ ফাইল নির্বাচন করে তখন Google ড্রাইভ একটি প্রাসঙ্গিক ট্রিগার প্রদান করে।
যখন একটি প্রাসঙ্গিক ট্রিগার ফায়ার হয়, হোস্ট অ্যাপ্লিকেশনটি অ্যাড-অন ম্যানিফেস্টে তালিকাভুক্ত সংশ্লিষ্ট
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 কেবলমাত্র উপস্থিত থাকলে কলিং হোস্টটি গুগল ক্যালেন্ডার হয় । ক্যালেন্ডার এবং ইভেন্টের তথ্যযুক্ত একটি অবজেক্ট। |
eventObject.chat | Chat event object কলিং হোস্ট গুগল চ্যাট হলে কেবল উপস্থিত । চ্যাট তথ্যযুক্ত একটি অবজেক্ট। |
eventObject.drive | Drive event object কলিং হোস্ট গুগল ড্রাইভ হলে কেবল উপস্থিত । ড্রাইভের তথ্যযুক্ত একটি অবজেক্ট। |
eventObject.gmail | Gmail event object কলিং হোস্টটি জিমেইল হলে কেবল উপস্থিত । জিমেইল তথ্যযুক্ত একটি অবজেক্ট। |
eventObject.docs | Docs event object কলিং হোস্ট গুগল ডক্স হয় কেবল তখনই উপস্থিত । ডক্সের তথ্যযুক্ত একটি অবজেক্ট। |
eventObject.sheets | Sheets event object কলিং হোস্ট গুগল শিট হলে কেবল উপস্থিত । শীট তথ্য সম্বলিত একটি অবজেক্ট। |
eventObject.slides | Slides event object কলিং হোস্ট গুগল স্লাইড হলে কেবল উপস্থিত । স্লাইড তথ্যযুক্ত একটি অবজেক্ট। |
আসল জিমেইল অ্যাড-অন ক্ষেত্রগুলি | |
eventObject.messageMetadata.accessToken | string অবচয়। একটি অ্যাক্সেস টোকেন। অস্থায়ী জিমেইল অ্যাড-অন স্কোপগুলি ব্যবহার করে ব্যবহারকারীর ডেটা অ্যাক্সেস চালু করতে আপনি এটি ব্যবহার করতে পারেন। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য, এই তথ্যটি |
eventObject.messageMetadata.messageId | string অবচয়। থ্রেডের বার্তা আইডি জিমেইল ইউআইতে খোলা। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য, এই তথ্যটি |
eventObject.clientPlatform | string অবচয়। ইভেন্টটি কোথায় উদ্ভূত হয় তা নির্দেশ করে (ওয়েব, আইওএস, বা অ্যান্ড্রয়েড)। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য, এই তথ্যটি |
eventObject.formInput | object অবচয়। কার্ডে সমস্ত ফর্ম উইজেটগুলির বর্তমান মানগুলির একটি মানচিত্র, প্রতি উইজেট প্রতি এক মানের মধ্যে সীমাবদ্ধ। কীগুলি হ'ল উইজেটগুলির সাথে যুক্ত স্ট্রিং আইডি এবং মানগুলি স্ট্রিং। ইভেন্ট অবজেক্টটি যখন আপনার একাধিক উইজেটগুলি থেকে ডেটা পড়তে হবে যার প্রত্যাশিত একক মান যেমন পাঠ্য ইনপুট এবং সুইচগুলির মতো ডেটা পড়তে হবে তখন formInput সরবরাহ করে। চেকবক্সের মতো মাল্টি-ভ্যালিউড উইজেটগুলির জন্য, আপনি পরিবর্তে formInputs থেকে প্রতিটি মান পড়তে পারেন। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য, এই তথ্যটি |
eventObject.formInputs | object অবচয়। কার্ডে উইজেটগুলির বর্তমান মানগুলির একটি মানচিত্র, স্ট্রিংগুলির তালিকা হিসাবে উপস্থাপিত। কীগুলি হ'ল উইজেটের সাথে যুক্ত স্ট্রিং আইডি। একক-মূল্যবান উইজেটগুলির জন্য, মানটি একক-উপাদান অ্যারেতে উপস্থাপন করা হয়। চেকবক্স গ্রুপগুলির মতো মাল্টি-ভ্যালিউড উইজেটগুলির জন্য, সমস্ত মান একটি তালিকায় উপস্থাপন করা হয়। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য, এই তথ্যটি |
eventObject.parameters | object অবচয়। Action.setParameters() ব্যবহার করে আপনি Action সরবরাহ করেন এমন কোনও অতিরিক্ত পরামিতিগুলির একটি মানচিত্র। মানচিত্র কী এবং মানগুলি স্ট্রিং। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য, এই তথ্যটি |
eventObject.userCountry | string ডিফল্টরূপে অবচয় এবং অক্ষম । দ্বি-অক্ষরের কোডটি ব্যবহারকারীর দেশ বা অঞ্চলকে নির্দেশ করে। এটি একটি সংখ্যাসূচক ইউএন এম 49 দেশ কোডও হতে পারে। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য, এই তথ্যটি |
eventObject.userLocale | string ডিফল্টরূপে অবচয় এবং অক্ষম । দ্বি-অক্ষরের আইএসও 639 কোডটি ব্যবহারকারীর ভাষা নির্দেশ করে। আরও তথ্যের জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য, এই তথ্যটি |
eventObject.userTimezone.id | string ডিফল্টরূপে অবচয় এবং অক্ষম । ব্যবহারকারীর টাইমজোনটির টাইমজোন শনাক্তকারী । উদাহরণগুলির মধ্যে রয়েছে: America/New_York , Europe/Vienna এবং Asia/Seoul । আরও তথ্যের জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য, এই তথ্যটি |
eventObject.userTimezone.offset | string ডিফল্টরূপে অবচয় এবং অক্ষম । মিলিসেকেন্ডে পরিমাপ করা ব্যবহারকারীর টাইমজোনটির সমন্বিত ইউনিভার্সাল টাইম (ইউটিসি) থেকে অফসেট সময় । আরও তথ্যের জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন। গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য, এই তথ্যটি |
সাধারণ ইভেন্ট অবজেক্ট
সাধারণ ইভেন্ট অবজেক্টটি হ'ল সামগ্রিক ইভেন্ট অবজেক্টের অংশ যা ব্যবহারকারীর ক্লায়েন্টের অ্যাড-অনকে সাধারণ, হোস্ট-স্বতন্ত্র তথ্য বহন করে। এই তথ্যে ব্যবহারকারীর লোকেল, হোস্ট অ্যাপ্লিকেশন এবং প্ল্যাটফর্মের মতো বিশদ অন্তর্ভুক্ত রয়েছে।
হোমপেজ এবং প্রাসঙ্গিক ট্রিগারগুলি ছাড়াও, অ্যাড-অনগুলি যখন ব্যবহারকারী উইজেটগুলির সাথে ইন্টারঅ্যাক্ট করে তখন অ্যাকশন কলব্যাক ফাংশনগুলিতে ইভেন্ট অবজেক্টগুলি তৈরি করে এবং পাস করে। আপনার অ্যাড-অনের কলব্যাক ফাংশনটি ব্যবহারকারীর ক্লায়েন্টে খোলা উইজেটগুলির বিষয়বস্তু নির্ধারণ করতে সাধারণ ইভেন্ট অবজেক্টকে জিজ্ঞাসা করতে পারে। উদাহরণস্বরূপ, আপনার অ্যাড-অন কোনও ব্যবহারকারী eventObject.commentEventObject.formInputs
অবজেক্টে একটি TextInput
উইজেটে প্রবেশ করেছে এমন পাঠ্যটি সনাক্ত করতে পারে।
সাধারণ ইভেন্ট অবজেক্ট ক্ষেত্র | |
---|---|
commonEventObject.platform | string ইভেন্টটি কোথায় উদ্ভূত হয় তা নির্দেশ করে (`ওয়েব`,` আইওএস`, বা `অ্যান্ড্রয়েড`)। |
commonEventObject.formInputs | object প্রদর্শিত কার্ডে উইজেটগুলির বর্তমান মানগুলি সমন্বিত একটি মানচিত্র। মানচিত্র কীগুলি প্রতিটি উইজেটের সাথে নির্ধারিত স্ট্রিং আইডি। মানচিত্রের মান অবজেক্টের কাঠামো উইজেটের ধরণের উপর নির্ভরশীল: উদাহরণস্বরূপ, অ্যাপ্লিকেশন স্ক্রিপ্টে রানটাইম সম্পর্কে আরও জানতে, ভি 8 রানটাইম ওভারভিউ দেখুন।
|
commonEventObject.hostApp | string ইভেন্ট অবজেক্টটি উত্পন্ন হওয়ার পরে অ্যাড-অনটি সক্রিয় রয়েছে এমন হোস্ট অ্যাপটি নির্দেশ করে। সম্ভাব্য মানগুলি নিম্নলিখিত অন্তর্ভুক্ত:
|
commonEventObject.parameters | object actionParameters বা Action.setParameters() ব্যবহার করে আপনি কোনও ক্রিয়াকলাপে সরবরাহ করেন এমন কোনও অতিরিক্ত পরামিতি। বিকাশকারী পূর্বরূপ: গুগল চ্যাট প্রসারিত অ্যাড-অনগুলির জন্য, ব্যবহারকারীরা মাল্টিসেলেক্ট মেনুগুলিতে কী টাইপ করে তার উপর ভিত্তি করে আইটেমগুলির পরামর্শ দেওয়ার জন্য, |
commonEventObject.userLocale | string ডিফল্টরূপে অক্ষম । আইএসও 639 ভাষা কোড- আইএসও 3166 দেশ/অঞ্চল কোডের ফর্ম্যাটে ব্যবহারকারীর ভাষা এবং দেশ/অঞ্চল সনাক্তকারী। উদাহরণস্বরূপ, en-US । এই ক্ষেত্রটি চালু করতে, আপনাকে অবশ্যই |
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 মিলিসেকেন্ডে পরিমাপ করা ব্যবহারকারীর টাইমজোনটির সমন্বিত ইউনিভার্সাল টাইম (ইউটিসি) থেকে অফসেট সময় । আরও তথ্যের জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন। |
তারিখ-সময় বাছাইকারী ফর্ম ইনপুট
অ্যাকশন কলব্যাক ফাংশনগুলি commonEventObject.formInputs
ক্ষেত্রে বর্তমান উইজেট মানগুলি গ্রহণ করতে পারে। এর মধ্যে তারিখ বা সময় বাছাইকারী উইজেটগুলিতে ব্যবহারকারীর নির্বাচিত তারিখ বা সময় মান অন্তর্ভুক্ত রয়েছে। যাইহোক, উইজেটটি তারিখ-সময় বাছাইকারী, কেবলমাত্র তারিখ-কেবলমাত্র পিকার, বা কেবল সময়-কেবলমাত্র বাছাইকারী হিসাবে কনফিগার করা হয়েছিল কিনা তার উপর নির্ভর করে তথ্যের কাঠামো পৃথক হয়। কাঠামোগত পার্থক্যগুলি নিম্নলিখিত সারণীতে বর্ণিত হয়েছে:
ক্যালেন্ডার ইভেন্ট অবজেক্ট
ক্যালেন্ডার ইভেন্ট অবজেক্টটি সামগ্রিক ইভেন্ট অবজেক্টের অংশ যা ব্যবহারকারীর ক্যালেন্ডার এবং ক্যালেন্ডার ইভেন্টগুলি সম্পর্কে তথ্য বহন করে। হোস্ট অ্যাপ্লিকেশনটি গুগল ক্যালেন্ডার হলে এটি কেবল কোনও ইভেন্ট অবজেক্টে উপস্থিত।
নিম্নলিখিত টেবিলটি কোনও ইভেন্ট অবজেক্টের calendarEventObject
ক্ষেত্রে উপস্থিত ক্ষেত্রগুলিকে তালিকাভুক্ত করে। ব্যবহারকারী-উত্পাদিত ডেটা হিসাবে চিহ্নিত ক্ষেত্রগুলি ইভেন্ট অবজেক্টে উপস্থিত থাকে যদি এবং READ
যদি ক্যালেন্ডার ইভেন্টে ডেটা READ_WRITE
থাকে এবং অ্যাড-অন তার addOns.calendar.currentEventAccess
সেট করে Cal
ক্যালেন্ডার ইভেন্ট অবজেক্ট | |
---|---|
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 ব্যবহারকারী-উত্পাদিত ডেটা। এই ইভেন্টের সাথে সম্পর্কিত যে কোনও সম্মেলনের ডেটা উপস্থাপন করে এমন একটি অবজেক্ট যেমন গুগল সম্মেলনের বিশদ পূরণ করে। |
calendar.id | string ইভেন্ট আইডি। |
calendar.organizer | object ইভেন্টের সংগঠকের প্রতিনিধিত্বকারী একটি বস্তু। |
calendar.organizer.email | string ইভেন্ট আয়োজকের ইমেল ঠিকানা। |
calendar.recurringEventId | string একটি পুনরাবৃত্তি ইভেন্টের আইডি। |
অংশগ্রহণকারী
অংশগ্রহণকারী অবজেক্টগুলি গুগল ক্যালেন্ডার ইভেন্টগুলিতে পৃথক উপস্থিতদের সম্পর্কে তথ্য বহন করে। এই তথ্যটি ইভেন্ট অবজেক্টে উপস্থিত থাকে যদি এবং READ
যদি ক্যালেন্ডার ইভেন্টে ডেটা READ_WRITE
থাকে এবং অ্যাড-অন তার addOns.calendar.currentEventAccess
সেট করে Cal
অংশগ্রহণকারী অবজেক্ট | |
---|---|
attendee.additionalGuests | number অংশগ্রহণকারীরা যে অতিরিক্ত অতিথিদের নিয়ে আসছেন তা নির্দেশ করেছিলেন। ডিফল্ট শূন্য। |
attendee.comment | string অংশগ্রহণকারীদের প্রতিক্রিয়া মন্তব্য, যদি থাকে। |
attendee.displayName | string অংশগ্রহণকারী নাম প্রদর্শিত। |
attendee.email | string অংশগ্রহণকারী ইমেল ঠিকানা। |
attendee.optional | boolean true যদি এই অংশগ্রহণকারীদের জন্য উপস্থিতি al চ্ছিক হিসাবে চিহ্নিত করা হয়; অন্যথায় false । |
attendee.organizer | boolean true যদি অংশগ্রহণকারী এই ইভেন্টের জন্য একজন সংগঠক হন। |
attendee.resource | boolean true যদি অংশগ্রহণকারী কোনও সংস্থান উপস্থাপন করে, যেমন ঘর বা সরঞ্জামের টুকরো; অন্যথায় false । |
attendee.responseStatus | string অংশগ্রহণকারীদের প্রতিক্রিয়া স্থিতি। সম্ভাব্য মানগুলি নিম্নলিখিত অন্তর্ভুক্ত:
|
attendee.self | boolean true যদি এই অংশগ্রহণকারী ক্যালেন্ডারটি উপস্থাপন করে যেখানে এই ইভেন্টটি প্রদর্শিত হবে; অন্যথায় false । |
সম্মেলনের ডেটা
সম্মেলনের ডেটা অবজেক্টগুলি গুগল ক্যালেন্ডার ইভেন্টগুলির সাথে সংযুক্ত সম্মেলনগুলি সম্পর্কে তথ্য বহন করে। এগুলি গুগল সম্মেলন সমাধান যেমন গুগল মিট বা তৃতীয় পক্ষের সম্মেলন হতে পারে। এই তথ্যটি ইভেন্ট অবজেক্টে উপস্থিত থাকে যদি এবং READ
যদি ক্যালেন্ডার ইভেন্টে ডেটা READ_WRITE
থাকে এবং অ্যাড-অন তার addOns.calendar.currentEventAccess
সেট করে Cal
সম্মেলনের ডেটা অবজেক্ট | |
---|---|
conferenceData.conferenceId | string সম্মেলনের আইডি। এই আইডি বোঝানো হয়েছে অ্যাপ্লিকেশনগুলিকে সম্মেলনের উপর নজর রাখতে অনুমতি দেওয়া; আপনার এই আইডি ব্যবহারকারীদের কাছে প্রদর্শন করা উচিত নয়। |
conferenceData.conferenceSolution | object সম্মেলন সমাধানের প্রতিনিধিত্বকারী একটি অবজেক্ট যেমন হ্যাঙ্গআউট বা গুগল সভা। |
conferenceData.conferenceSolution.iconUri | string এই সম্মেলন সমাধানের প্রতিনিধিত্বকারী ব্যবহারকারী-দৃশ্যমান আইকনটির জন্য ইউআরআই। |
conferenceData.conferenceSolution.key | object এই ইভেন্টটির জন্য সম্মেলনের সমাধানটি অনন্যভাবে চিহ্নিত করে এমন কী। |
conferenceData.conferenceSolution.key.type | string সম্মেলনের সমাধানের ধরণ। সম্ভাব্য মানগুলি নিম্নলিখিত অন্তর্ভুক্ত:
|
conferenceData.conferenceSolution.name | string এই সম্মেলন সমাধানের ব্যবহারকারী-দৃশ্যমান নাম (স্থানীয় নয়)। |
conferenceData.entryPoints[] | list of entry point objects সম্মেলন প্রবেশের পয়েন্টগুলির তালিকা যেমন ইউআরএল বা ফোন নম্বর। |
conferenceData.notes | string ব্যবহারকারীর কাছে প্রদর্শন করার জন্য সম্মেলন সম্পর্কে অতিরিক্ত নোট (যেমন ডোমেন প্রশাসক বা আইনী বিজ্ঞপ্তিগুলির নির্দেশাবলী)। এইচটিএমএল থাকতে পারে। সর্বাধিক দৈর্ঘ্য 2048 অক্ষর। |
conferenceData.parameters | object অ্যাড-অন দ্বারা ব্যবহারের জন্য সংজ্ঞায়িত প্যারামিটার ডেটার মানচিত্রযুক্ত একটি অবজেক্ট। |
conferenceData.parameters.addOnParameters | object প্যারামিটার স্ট্রিং কী এবং মানগুলির একটি মানচিত্র। এই কীগুলি এবং মানগুলি অ্যাড-অন বিকাশকারী দ্বারা অ্যাড-অনের ব্যবহারের জন্য একটি নির্দিষ্ট সম্মেলনে তথ্য সংযুক্ত করার জন্য সংজ্ঞায়িত করা হয়। |
এন্ট্রি পয়েন্ট
এন্ট্রি পয়েন্ট অবজেক্টগুলি কোনও প্রদত্ত সম্মেলন যেমন ফোন বা ভিডিওতে অ্যাক্সেসের প্রতিষ্ঠিত উপায় সম্পর্কে তথ্য বহন করে। এই তথ্যটি ইভেন্ট অবজেক্টে উপস্থিত থাকে যদি এবং READ
যদি ক্যালেন্ডার ইভেন্টে ডেটা READ_WRITE
থাকে এবং অ্যাড-অন তার addOns.calendar.currentEventAccess
সেট করে Cal
এন্ট্রি পয়েন্ট অবজেক্ট | |
---|---|
entryPoint.accessCode | string সম্মেলনে অ্যাক্সেস করতে ব্যবহৃত অ্যাক্সেস কোড। সর্বাধিক দৈর্ঘ্য 128 অক্ষর। সম্মেলন সরবরাহকারীরা সাধারণত সম্মেলনগুলিতে অ্যাক্সেস সরবরাহ করতে কেবল { accessCode , meetingCode , passcode , password , pin of এর একটি উপসেট ব্যবহার করেন। সম্মেলন সরবরাহকারী যে ক্ষেত্রগুলি ব্যবহার করে তা কেবল ম্যাচ করুন এবং কেবল কখনও প্রদর্শন করুন। |
entryPoint.entryPointFeatures | list এন্ট্রি পয়েন্টের বৈশিষ্ট্য। বর্তমানে এই বৈশিষ্ট্যগুলি কেবল phone এন্ট্রি পয়েন্টগুলিতে প্রযোজ্য:
|
entryPoint.entryPointType | string প্রবেশ পয়েন্টের ধরণ। সম্ভাব্য মানগুলি নিম্নলিখিত:
|
entryPoint.label | string এন্ট্রি পয়েন্ট ইউআরআই (স্থানীয় নয়) এর জন্য ব্যবহারকারী-দৃশ্যমান লেবেল। |
entryPoint.meetingCode | string সম্মেলনে অ্যাক্সেস করতে ব্যবহৃত সভা কোড। সর্বাধিক দৈর্ঘ্য 128 অক্ষর। সম্মেলন সরবরাহকারীরা সাধারণত সম্মেলনগুলিতে অ্যাক্সেস সরবরাহ করতে কেবল { accessCode , meetingCode , passcode , password , pin of এর একটি উপসেট ব্যবহার করেন। সম্মেলন সরবরাহকারী যে ক্ষেত্রগুলি ব্যবহার করে তা কেবল ম্যাচ করুন এবং কেবল কখনও প্রদর্শন করুন। |
entryPoint.passcode | string পাসকোড সম্মেলনে অ্যাক্সেস করতে ব্যবহৃত হত। সর্বাধিক দৈর্ঘ্য 128 অক্ষর। সম্মেলন সরবরাহকারীরা সাধারণত সম্মেলনগুলিতে অ্যাক্সেস সরবরাহ করতে কেবল { accessCode , meetingCode , passcode , password , pin of এর একটি উপসেট ব্যবহার করেন। সম্মেলন সরবরাহকারী যে ক্ষেত্রগুলি ব্যবহার করে তা কেবল ম্যাচ করুন এবং কেবল কখনও প্রদর্শন করুন। |
entryPoint.password | string সম্মেলনে অ্যাক্সেস করতে ব্যবহৃত পাসওয়ার্ড। সর্বাধিক দৈর্ঘ্য 128 অক্ষর। সম্মেলন সরবরাহকারীরা সাধারণত সম্মেলনগুলিতে অ্যাক্সেস সরবরাহ করতে কেবল { accessCode , meetingCode , passcode , password , pin of এর একটি উপসেট ব্যবহার করেন। সম্মেলন সরবরাহকারী যে ক্ষেত্রগুলি ব্যবহার করে তা কেবল ম্যাচ করুন এবং কেবল কখনও প্রদর্শন করুন। |
entryPoint.pin | string পিনটি সম্মেলনে অ্যাক্সেস করত। সর্বাধিক দৈর্ঘ্য 128 অক্ষর। সম্মেলন সরবরাহকারীরা সাধারণত সম্মেলনগুলিতে অ্যাক্সেস সরবরাহ করতে কেবল { accessCode , meetingCode , passcode , password , pin of এর একটি উপসেট ব্যবহার করেন। সম্মেলন সরবরাহকারী যে ক্ষেত্রগুলি ব্যবহার করে তা কেবল ম্যাচ করুন এবং কেবল কখনও প্রদর্শন করুন। |
entryPoint.regionCode | string ফোন নম্বর অঞ্চল কোড। ব্যবহারকারীদের দ্বারা প্রয়োজনীয় যদি ইউআরআই কোনও দেশের কোড অন্তর্ভুক্ত না করে। মানগুলি অঞ্চল কোডগুলির সর্বজনীন সিএলডিআর তালিকার উপর ভিত্তি করে। |
entryPoint.uri | string এন্ট্রি পয়েন্টের ইউআরআই। সর্বাধিক দৈর্ঘ্য 1300 অক্ষর। ফর্ম্যাটিং এন্ট্রি পয়েন্টের ধরণের উপর নির্ভর করে:
|
ড্রাইভ ইভেন্ট অবজেক্ট
ড্রাইভ ইভেন্ট অবজেক্টটি সামগ্রিক ইভেন্ট অবজেক্টের অংশ যা কোনও ব্যবহারকারীর গুগল ড্রাইভ এবং এর বিষয়বস্তু সম্পর্কিত তথ্য বহন করে। হোস্ট অ্যাপ্লিকেশনটি গুগল ড্রাইভ হলে এটি কেবলমাত্র কোনও ইভেন্ট অবজেক্টে উপস্থিত।
ড্রাইভ ইভেন্ট অবজেক্ট | |
---|---|
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 আইকনের ইউআরএল যা নির্বাচিত আইটেমটিকে উপস্থাপন করে। |
item.mimeType | string নির্বাচিত আইটেমের মাইম টাইপ। |
item.title | string নির্বাচিত আইটেমের শিরোনাম। |
জিমেইল ইভেন্ট অবজেক্ট
জিমেইল ইভেন্ট অবজেক্টটি সামগ্রিক ইভেন্ট অবজেক্টের অংশ যা কোনও ব্যবহারকারীর জিমেইল বার্তাগুলি সম্পর্কে তথ্য বহন করে। হোস্ট অ্যাপ্লিকেশনটি জিমেইল হলে এটি কেবল কোনও ইভেন্ট অবজেক্টে উপস্থিত।
জিমেইল ইভেন্ট অবজেক্ট | |
---|---|
gmail.accessToken | string জিমেইল-নির্দিষ্ট অ্যাক্সেস টোকেন। আপনি কোনও ব্যবহারকারীর বর্তমানে ওপেন জিমেইল বার্তায় আপনার অ্যাড-অন অস্থায়ী অ্যাক্সেস মঞ্জুর করতে বা আপনার অ্যাড-অনকে নতুন খসড়া রচনা করতে দিনে আপনি GmailApp.setCurrentMessageAccessToken(accessToken) পদ্ধতিতে এই টোকেনটি ব্যবহার করতে পারেন। |
gmail.bccRecipients[] | list of strings ডিফল্টরূপে অক্ষম । "বিসিসি:" এর তালিকা বর্তমানে অ্যাড-অনের একটি খসড়াতে অন্তর্ভুক্ত প্রাপক ইমেল ঠিকানাগুলি রচনা করছে। এই ক্ষেত্রটি চালু করতে, আপনাকে অবশ্যই METADATA আপনার ম্যানিফেস্টে addOns.gmail.composeTrigger.draftAccess । Gmail.composetrigger.draftaccess ক্ষেত্র সেট করতে হবে। |
gmail.ccRecipients[] | list of strings ডিফল্টরূপে অক্ষম । "সিসি:" প্রাপক ইমেল ঠিকানাগুলির তালিকা বর্তমানে অ্যাড-অন একটি খসড়াটিতে অন্তর্ভুক্ত রয়েছে। এই ক্ষেত্রটি চালু করতে, আপনাকে অবশ্যই METADATA আপনার ম্যানিফেস্টে addOns.gmail.composeTrigger.draftAccess । Gmail.composetrigger.draftaccess ক্ষেত্র সেট করতে হবে। |
gmail.messageId | string বর্তমানে খোলা জিমেইল বার্তার আইডি। |
gmail.threadId | string বর্তমানে খোলা জিমেইল থ্রেড আইডি। |
gmail.toRecipients[] | list of strings ডিফল্টরূপে অক্ষম । "টু:" এর তালিকা বর্তমানে অ্যাড-অনের একটি খসড়াতে অন্তর্ভুক্ত প্রাপক ইমেল ঠিকানাগুলি রচনা করছে। এই ক্ষেত্রটি চালু করতে, আপনাকে অবশ্যই METADATA আপনার ম্যানিফেস্টে addOns.gmail.composeTrigger.draftAccess । Gmail.composetrigger.draftaccess ক্ষেত্র সেট করতে হবে। |
ডক্স ইভেন্ট অবজেক্ট
ডক্স ইভেন্ট অবজেক্টটি সামগ্রিক ইভেন্ট অবজেক্টের অংশ যা কোনও ব্যবহারকারীর নথি এবং এর বিষয়বস্তু সম্পর্কিত তথ্য বহন করে। হোস্ট অ্যাপ্লিকেশনটি গুগল ডক্স হলে এটি কেবল কোনও ইভেন্ট অবজেক্টে উপস্থিত।
ডক্স ইভেন্ট অবজেক্ট | |
---|---|
docs.id | string কেবলমাত্র উপস্থিত থাকলে যদি https://www.googleapis.com/auth/drive.file স্কোপ ব্যবহারকারী দ্বারা অনুমোদিত হয় ।দস্তাবেজের আইডিটি ডক্স ইউআইতে খোলা। |
docs.title | string কেবলমাত্র উপস্থিত থাকলে যদি https://www.googleapis.com/auth/drive.file স্কোপ ব্যবহারকারী দ্বারা অনুমোদিত হয় ।ডক্টস ইউআই -তে খোলা নথির শিরোনাম। |
docs.addonHasFileScopePermission | boolean যদি true , অ্যাড-অনটি ডক্টস ইউআই-তে খোলা নথির জন্য https://www.googleapis.com/auth/drive.file স্কোপ অনুমোদনের জন্য অনুরোধ করেছে এবং পেয়েছে; অন্যথায় এই ক্ষেত্রটি false । |
docs.matchedUrl.url | string নিম্নলিখিত শর্তগুলি পূরণ করা হলে কেবল উপস্থিত:
লিঙ্কটির ইউআরএল যা গুগল ডক্সে একটি পূর্বরূপ উত্পন্ন করে। এই ক্ষেত্রটি ব্যবহার করতে, আপনাকে অবশ্যই আপনার অ্যাড-অনের ম্যানিফেস্টে LinkPreviewTriggers কনফিগার করতে হবে। আরও তথ্যের জন্য স্মার্ট চিপগুলির সাথে পূর্বরূপ লিঙ্কগুলি দেখুন। উদাহরণস্বরূপ পে -লোড যখন কোনও ব্যবহারকারী লিঙ্কটির পূর্বরূপ দেয় "docs" : { "matchedUrl" : { "url" : "https://www.example.com/12345" } } |
শীট ইভেন্ট অবজেক্ট
শীট ইভেন্ট অবজেক্টটি সামগ্রিক ইভেন্ট অবজেক্টের অংশ যা কোনও ব্যবহারকারীর নথি এবং এর বিষয়বস্তু সম্পর্কিত তথ্য বহন করে। হোস্ট অ্যাপ্লিকেশনটি গুগল শিট হলে এটি কেবল কোনও ইভেন্ট অবজেক্টে উপস্থিত।
শীট ইভেন্ট অবজেক্ট | |
---|---|
sheets.id | string কেবলমাত্র উপস্থিত থাকলে যদি https://www.googleapis.com/auth/drive.file স্কোপ ব্যবহারকারী দ্বারা অনুমোদিত হয় । স্প্রেডশিটের আইডি শিটগুলি ইউআইতে খোলা। |
sheets.title | string কেবলমাত্র উপস্থিত থাকলে যদি https://www.googleapis.com/auth/drive.file স্কোপ ব্যবহারকারী দ্বারা অনুমোদিত হয় । শিটস ইউআই -তে স্প্রেডশিটের শিরোনাম খোলা। |
sheets.addonHasFileScopePermission | boolean যদি true তবে অ্যাড-অনটি https://www.googleapis.com/auth/drive.file শিট ইউআইতে স্প্রেডশিট খোলা জন্য স্কোপ অনুমোদনের জন্য অনুরোধ করেছে এবং পেয়েছে; অন্যথায় এই ক্ষেত্রটি false । |
sheets.matchedUrl.url | string নিম্নলিখিত শর্তগুলি পূরণ করা হলে কেবল উপস্থিত:
লিঙ্কটির ইউআরএল যা গুগল শিটগুলিতে একটি পূর্বরূপ উত্পন্ন করে। এই ক্ষেত্রটি ব্যবহার করতে, আপনাকে অবশ্যই আপনার অ্যাড-অনের ম্যানিফেস্টে LinkPreviewTriggers কনফিগার করতে হবে। আরও তথ্যের জন্য স্মার্ট চিপগুলির সাথে পূর্বরূপ লিঙ্কগুলি দেখুন। উদাহরণস্বরূপ পে -লোড যখন কোনও ব্যবহারকারী লিঙ্কটির পূর্বরূপ দেয় "sheets" : { "matchedUrl" : { "url" : "https://www.example.com/12345" } } |
স্লাইড ইভেন্ট অবজেক্ট
স্লাইডস ইভেন্ট অবজেক্টটি সামগ্রিক ইভেন্ট অবজেক্টের অংশ যা কোনও ব্যবহারকারীর ডকুমেন্ট এবং এর বিষয়বস্তু সম্পর্কিত তথ্য বহন করে। এটি কেবলমাত্র কোনও ইভেন্ট অবজেক্টে উপস্থিত থাকে যদি হোস্ট অ্যাপ্লিকেশনটি গুগল স্লাইড হয়।
স্লাইড ইভেন্ট অবজেক্ট | |
---|---|
slides.id | string কেবলমাত্র উপস্থিত থাকলে যদি https://www.googleapis.com/auth/drive.file স্কোপ ব্যবহারকারী দ্বারা অনুমোদিত হয় । উপস্থাপনার আইডি স্লাইডগুলি ইউআইতে খোলা। |
slides.title | string কেবলমাত্র উপস্থিত থাকলে যদি https://www.googleapis.com/auth/drive.file স্কোপ ব্যবহারকারী দ্বারা অনুমোদিত হয় । স্লাইডগুলি ইউআইতে উপস্থাপনের শিরোনাম খোলা। |
slides.addonHasFileScopePermission | boolean যদি true তবে অ্যাড-অনটি https://www.googleapis.com/auth/drive.file স্কোপ অনুমোদনের জন্য স্লাইড ইউআইতে খোলা উপস্থাপনার জন্য স্কোপ অনুমোদনের জন্য অনুরোধ করেছে এবং পেয়েছে; অন্যথায় এই ক্ষেত্রটি false । |
slides.matchedUrl.url | string নিম্নলিখিত শর্তগুলি পূরণ করা হলে কেবল উপস্থিত:
লিঙ্কটির ইউআরএল যা গুগল স্লাইডগুলিতে একটি পূর্বরূপ উত্পন্ন করে। এই ক্ষেত্রটি ব্যবহার করতে, আপনাকে অবশ্যই আপনার অ্যাড-অনের ম্যানিফেস্টে LinkPreviewTriggers কনফিগার করতে হবে। আরও তথ্যের জন্য স্মার্ট চিপগুলির সাথে পূর্বরূপ লিঙ্কগুলি দেখুন। উদাহরণস্বরূপ পে -লোড যখন কোনও ব্যবহারকারী লিঙ্কটির পূর্বরূপ দেয় "slides" : { "matchedUrl" : { "url" : "https://www.example.com/12345" } } |