ব্যবহারকারী যখন Google ড্রাইভ ব্যবহার করছেন তখন Google Workspace অ্যাড-অনগুলি কাস্টমাইজড ইন্টারফেস প্রদান করতে পারে। এটি আপনাকে ব্যবহারকারীকে অতিরিক্ত প্রাসঙ্গিক তথ্য প্রদান করতে, কাজগুলি স্বয়ংক্রিয় করতে এবং তৃতীয় পক্ষের সিস্টেমগুলিকে Google ড্রাইভে সংযুক্ত করতে দেয়৷
অ্যাড-অন UI অ্যাক্সেস করা হচ্ছে
আপনি Google ড্রাইভে একটি Google Workspace অ্যাড-অন খুলতে পারেন যদি এটির আইকনটি ড্রাইভ ব্যবহারকারী ইন্টারফেসের ডানদিকে আইকন কলামে দেখা যায়। একটি Google Workspace অ্যাড-অন একটি হোমপেজ ইন্টারফেস, একটি আইটেম নির্বাচন ইন্টারফেস বা উভয়ই সংজ্ঞায়িত করতে পারে:
- গুগল ড্রাইভে থাকা অবস্থায় কোনো ব্যবহারকারী অ্যাড-অন আইকনে ক্লিক করলে, অ্যাড-অন সংশ্লিষ্ট
drive.homepageTriggerফাংশন (যদি উপস্থিত থাকে) চালায়। এই ফাংশনটি প্রদর্শনের জন্য Google ড্রাইভে একটি হোমপেজ কার্ড তৈরি করে এবং ফেরত দেয়। যদি কোনোdrive.homepageTriggerফাংশন সংজ্ঞায়িত করা না থাকে, তাহলে এর পরিবর্তে একটি জেনেরিক হোমপেজ কার্ড প্রদর্শিত হয়। - যদি ব্যবহারকারী Google ড্রাইভে এক বা একাধিক আইটেম নির্বাচন করে এবং তারপর অ্যাড-অন আইকনে ক্লিক করে, বা অ্যাড-অন খোলা থাকাকালীন আইটেমগুলি নির্বাচন করে, অ্যাড-অন সংশ্লিষ্ট
drive.onItemsSelectedTriggerপ্রাসঙ্গিক ফাংশন (যদি উপস্থিত থাকে) চালায়। এই ফাংশন অ্যাড-অন-এর Google ড্রাইভ প্রাসঙ্গিক "আইটেম নির্বাচিত" ইন্টারফেস তৈরি করে এবং প্রদর্শনের জন্য Google ড্রাইভে ফেরত দেয়।
অ্যাড-অন ড্রাইভ ইন্টারফেস তৈরি করা হচ্ছে
আপনি এই সাধারণ পদক্ষেপগুলি অনুসরণ করে Google ড্রাইভকে প্রসারিত করে এমন ইন্টারফেস তৈরি করতে পারেন:
- আপনি আপনার অ্যাড-অনে একটি ড্রাইভ-নির্দিষ্ট হোমপেজ রাখতে চান কিনা তা নির্ধারণ করুন৷ ব্যবহারকারী যখন ড্রাইভ আইটেমগুলি নির্বাচন করেন তখন আপনি একটি প্রাসঙ্গিক ইন্টারফেস প্রদান করতে চান কিনা তাও সিদ্ধান্ত নিন।
- অ্যাড-অন স্ক্রিপ্ট প্রোজেক্ট ম্যানিফেস্টে উপযুক্ত
addOns.commonএবংaddOns.driveক্ষেত্রগুলি যোগ করুন, যেকোন ড্রাইভ স্কোপ সহ প্রয়োজনীয়। - আপনি যদি একটি ড্রাইভ-নির্দিষ্ট হোমপেজ প্রদান করেন, তাহলে এই ইন্টারফেসটি তৈরি করতে
drive.homepageTriggerফাংশনটি প্রয়োগ করুন। এছাড়াও আপনি একাধিক Google Workspace হোস্টের জন্যcommon.homepageTriggerইন্টারফেস ব্যবহার করতে পারেন। - আপনি যদি একটি ড্রাইভ প্রাসঙ্গিক আইটেম নির্বাচন ইন্টারফেস প্রদান করেন, তাহলে এই ইন্টারফেসটি তৈরি করতে আপনাকে অবশ্যই একটি
drive.onItemsSelectedTriggerপ্রাসঙ্গিক ট্রিগার ফাংশন প্রয়োগ করতে হবে। বিশদ বিবরণের জন্য নির্বাচিত আইটেমগুলির জন্য ড্রাইভ প্রাসঙ্গিক ইন্টারফেস দেখুন। - ব্যবহারকারীর UI ইন্টারঅ্যাকশনগুলিতে প্রতিক্রিয়া জানাতে প্রয়োজনীয় সংশ্লিষ্ট কলব্যাক ফাংশনগুলি প্রয়োগ করুন, যেমন বোতাম ক্লিক৷
ড্রাইভ হোমপেজ
Google ড্রাইভ Google Workspace অ্যাড-অন হোমপেজ দেখানো সমর্থন করে। Google ড্রাইভে আপনার অ্যাড-অনের সাধারণ হোমপেজটি দেখানোর জন্য কেবল নিশ্চিত করুন যে অ্যাড-অনের ম্যানিফেস্টে একটি addOns.drive ক্ষেত্র রয়েছে৷
বিকল্পভাবে, একটি ড্রাইভ-নির্দিষ্ট হোমপেজ প্রদান করতে অ্যাড-অন ম্যানিফেস্টে একটি drive.homepageTrigger যোগ করুন।
উভয় ক্ষেত্রেই, আপনাকে আপনার অ্যাড-অনের স্ক্রিপ্ট প্রকল্পে একটি হোমপেজ ট্রিগার ফাংশনের নাম প্রদান করতে হবে। যখন প্রয়োজন হয় তখন এই ফাংশনটি ড্রাইভ হোমপেজ তৈরি করতে স্বয়ংক্রিয়ভাবে কল করা হয়। হোমপেজ তৈরি করে এমন একটি Card বা Card অবজেক্টের একটি অ্যারে তৈরি করতে এবং ফেরত দিতে আপনাকে অবশ্যই এই ফাংশনটি বাস্তবায়ন করতে হবে। হোমপেজ ট্রিগার ফাংশনটি একটি ইভেন্ট অবজেক্টকে একটি প্যারামিটার হিসাবে পাস করা হয় যাতে ক্লায়েন্টের প্ল্যাটফর্মের মতো কিছু সাধারণ তথ্য থাকে। হোমপেজ নির্মাণের জন্য আপনি ইভেন্ট অবজেক্ট ডেটা ব্যবহার করতে পারেন।
নির্বাচিত আইটেমগুলির জন্য প্রাসঙ্গিক ইন্টারফেস ড্রাইভ করুন
ব্যবহারকারী যখন এক বা একাধিক Google ড্রাইভ আইটেম নির্বাচন করেন তখন কোন ইন্টারফেস (যদি থাকে) প্রদর্শন করতে হবে তা নির্ধারণ করতে Google ড্রাইভ একটি প্রাসঙ্গিক ট্রিগারের উপর নির্ভর করে। ট্রিগার ফায়ার হলে, এটি অ্যাড-অন ম্যানিফেস্টে drive.onItemsSelectedTrigger.runFunction ফিল্ড দ্বারা নির্দিষ্ট করা প্রাসঙ্গিক ট্রিগার ফাংশনটি চালায়।
ড্রাইভের জন্য একটি প্রাসঙ্গিক আইটেম নির্বাচন ইন্টারফেস তৈরি করতে, আপনাকে অবশ্যই নিম্নলিখিতগুলি করতে হবে:
অ্যাড-অনের ম্যানিফেস্টে
https://www.googleapis.com/auth/drive.addons.metadata.readonlyস্কোপ অন্তর্ভুক্ত রয়েছে তা নিশ্চিত করুননিশ্চিত করুন যে ম্যানিফেস্টে একটি
drive.onItemsSelectedTriggerবিভাগ অন্তর্ভুক্ত রয়েছে৷drive.onItemsSelectedTriggerফিল্ডে নামের ফাংশনটি প্রয়োগ করুন। এই ফাংশনটি একটি ইভেন্ট অবজেক্টকে একটি আর্গুমেন্ট হিসাবে গ্রহণ করে এবং অবশ্যই একটি এককCardঅবজেক্ট বাCardঅবজেক্টের একটি অ্যারে দিতে হবে।যেকোনো কার্ডের মতো, আপনাকে অবশ্যই ইন্টারফেসের জন্য উইজেট ইন্টারঅ্যাক্টিভিটি প্রদানের জন্য ব্যবহৃত যেকোনো কলব্যাক ফাংশন বাস্তবায়ন করতে হবে। উদাহরণস্বরূপ, যদি আপনি ইন্টারফেসে একটি বোতাম অন্তর্ভুক্ত করেন, তাহলে এটিতে একটি সংযুক্ত অ্যাকশন এবং একটি বাস্তবায়িত কলব্যাক ফাংশন থাকা উচিত যা বোতামটি ক্লিক করা হলে চলবে৷
ঘটনা বস্তু
একটি ইভেন্ট অবজেক্ট তৈরি করা হয় এবং drive.homepageTrigger বা drive.onItemsSelectedTrigger ট্রিগার ফাংশনে পাঠানো হয় যখন সেই ফাংশনগুলিকে কল করা হয়। ট্রিগার ফাংশন এই ইভেন্ট অবজেক্টের তথ্য ব্যবহার করে কিভাবে অ্যাড-অন কার্ড তৈরি করতে হয় বা অন্যথায় অ্যাড-অন আচরণ নিয়ন্ত্রণ করতে পারে।
ইভেন্ট অবজেক্টের সম্পূর্ণ গঠন ইভেন্ট অবজেক্টে বর্ণনা করা হয়েছে। যখন ড্রাইভ অ্যাড-অনের অভিনয় হোস্ট অ্যাপ হয়, তখন প্রাসঙ্গিক ইভেন্ট অবজেক্ট ড্রাইভ ইভেন্ট অবজেক্ট ক্ষেত্র অন্তর্ভুক্ত করে যা ড্রাইভ-নির্দিষ্ট ক্লায়েন্ট তথ্য বহন করে।
আইটেম নির্বাচন ট্রিগারের জন্য প্রাসঙ্গিক ড্রাইভ ইভেন্ট অবজেক্টে ট্রিগার ফায়ার হওয়ার সময় ব্যবহারকারীর নির্বাচন করা আইটেমগুলির তথ্য অন্তর্ভুক্ত থাকে। যখন একজন ব্যবহারকারী ড্রাইভে একাধিক আইটেম নির্বাচন করেন, তখন আইটেমগুলির মধ্যে একটিকে প্রাথমিক আগ্রহের একটি হিসাবে গণ্য করা হয়; এই আইটেমটিকে সক্রিয় কার্সার আইটেম হিসাবে উল্লেখ করা হয়।
নিম্নলিখিত উদাহরণটি একটি ড্রাইভ ইভেন্ট অবজেক্ট দেখায় যা একটি drive.onItemsSelectedTrigger ফাংশনে পাস করা হয়েছে:
{
"commonEventObject": { ... },
"drive": {
"activeCursorItem":{
"addonHasFileScopePermission": true,
"id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
"iconUrl": "https://drive-thirdparty.googleusercontent.com...",
"mimeType":"application/pdf",
"title":"How to get started with Drive"
},
"selectedItems": [
{
"addonHasFileScopePermission": true,
"id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
"iconUrl":"https://drive-thirdparty.googleusercontent.com...",
"mimeType":"application/pdf",
"title":"How to get started with Drive"
},
...
]
},
...
}