ব্যবহারকারী যখন গুগল ড্রাইভ ব্যবহার করেন তখন গুগল ওয়ার্কস্পেস অ্যাড-অনগুলি কাস্টমাইজড ইন্টারফেস প্রদান করতে পারে। এটি আপনাকে ব্যবহারকারীকে অতিরিক্ত প্রাসঙ্গিক তথ্য প্রদান করতে, কাজগুলি স্বয়ংক্রিয় করতে এবং তৃতীয় পক্ষের সিস্টেমগুলিকে গুগল ড্রাইভের সাথে সংযুক্ত করতে দেয়।
অ্যাড-অন UI অ্যাক্সেস করা
আপনি Google Drive-এ একটি Google Workspace অ্যাড-অন খুলতে পারেন যদি এর আইকনটি Drive ইউজার ইন্টারফেসের ডান দিকের আইকন কলামে প্রদর্শিত হয়। একটি Google Workspace অ্যাড-অন একটি হোমপেজ ইন্টারফেস, একটি আইটেম নির্বাচন ইন্টারফেস, অথবা উভয়ই সংজ্ঞায়িত করতে পারে:
- গুগল ড্রাইভে থাকাকালীন যদি কোনও ব্যবহারকারী অ্যাড-অন আইকনে ক্লিক করেন, তাহলে অ্যাড-অনটি সংশ্লিষ্ট
drive.homepageTriggerফাংশনটি (যদি থাকে) কার্যকর করে। এই ফাংশনটি প্রদর্শনের জন্য গুগল ড্রাইভে একটি হোমপেজ কার্ড তৈরি করে এবং ফেরত পাঠায়। যদি কোনওdrive.homepageTriggerফাংশন সংজ্ঞায়িত না থাকে, তাহলে পরিবর্তে একটি জেনেরিক হোমপেজ কার্ড প্রদর্শিত হবে। - যদি ব্যবহারকারী গুগল ড্রাইভে এক বা একাধিক আইটেম নির্বাচন করে এবং তারপর অ্যাড-অন আইকনে ক্লিক করে, অথবা অ্যাড-অন খোলা থাকা অবস্থায় আইটেম নির্বাচন করে, তাহলে অ্যাড-অনটি সংশ্লিষ্ট
drive.onItemsSelectedTriggerকনটেক্সচুয়াল ফাংশন (যদি থাকে) কার্যকর করে। এই ফাংশনটি অ্যাড-অনের গুগল ড্রাইভ কনটেক্সচুয়াল "আইটেম নির্বাচিত" ইন্টারফেস তৈরি করে এবং প্রদর্শনের জন্য গুগল ড্রাইভে ফেরত পাঠায়।
অ্যাড-অন ড্রাইভ ইন্টারফেস তৈরি করা
আপনি এই সাধারণ পদক্ষেপগুলি অনুসরণ করে গুগল ড্রাইভকে প্রসারিত করে এমন ইন্টারফেস তৈরি করতে পারেন:
- আপনার অ্যাড-অনটিতে একটি ড্রাইভ-নির্দিষ্ট হোমপেজ থাকবে কিনা তা স্থির করুন। ব্যবহারকারী যখন ড্রাইভ আইটেম নির্বাচন করবেন তখন আপনি একটি প্রাসঙ্গিক ইন্টারফেস প্রদান করতে চান কিনা তাও স্থির করুন।
- অ্যাড-অন স্ক্রিপ্ট প্রজেক্ট ম্যানিফেস্টে উপযুক্ত
addOns.commonএবংaddOns.driveক্ষেত্রগুলি যোগ করুন, প্রয়োজনীয় যেকোনো ড্রাইভ স্কোপ সহ। - যদি আপনি একটি ড্রাইভ-নির্দিষ্ট হোমপেজ প্রদান করেন, তাহলে এই ইন্টারফেসটি তৈরি করতে
drive.homepageTriggerফাংশনটি প্রয়োগ করুন। আপনি একাধিক Google Workspace হোস্টের জন্যcommon.homepageTriggerইন্টারফেসটি ব্যবহার করতেও পারেন। - যদি আপনি একটি ড্রাইভ প্রাসঙ্গিক আইটেম নির্বাচন ইন্টারফেস প্রদান করেন, তাহলে এই ইন্টারফেসটি তৈরি করতে আপনাকে একটি
drive.onItemsSelectedTriggerপ্রাসঙ্গিক ট্রিগার ফাংশন বাস্তবায়ন করতে হবে। বিস্তারিত জানার জন্য নির্বাচিত আইটেমগুলির জন্য ড্রাইভ প্রাসঙ্গিক ইন্টারফেস দেখুন)। - ব্যবহারকারীর UI ইন্টারঅ্যাকশন, যেমন বোতাম ক্লিকের প্রতিক্রিয়া জানাতে প্রয়োজনীয় সংশ্লিষ্ট কলব্যাক ফাংশনগুলি বাস্তবায়ন করুন।
ড্রাইভ হোমপেজ
গুগল ড্রাইভ গুগল ওয়ার্কস্পেস অ্যাড-অন হোমপেজ প্রদর্শন সমর্থন করে। গুগল ড্রাইভে আপনার অ্যাড-অনের সাধারণ হোমপেজটি দেখানোর জন্য কেবল নিশ্চিত করুন যে অ্যাড-অনের ম্যানিফেস্টে একটি 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 ট্রিগার ফাংশনে পাঠানো হয় যখন এই ফাংশনগুলি কল করা হয়। ট্রিগার ফাংশনটি এই ইভেন্ট অবজেক্টের তথ্য ব্যবহার করে অ্যাড-অন কার্ড কীভাবে তৈরি করতে হয় বা অন্যথায় অ্যাড-অন আচরণ নিয়ন্ত্রণ করতে পারে তা নির্ধারণ করতে পারে।
ইভেন্ট অবজেক্টের সম্পূর্ণ কাঠামো Event objects এ বর্ণনা করা হয়েছে। যখন Drive অ্যাড-অনের কার্যকরী হোস্ট অ্যাপ হয়, তখন প্রাসঙ্গিক ইভেন্ট অবজেক্টের মধ্যে Drive ইভেন্ট অবজেক্ট ক্ষেত্র অন্তর্ভুক্ত থাকে যা Drive-নির্দিষ্ট ক্লায়েন্ট তথ্য বহন করে।
আইটেম নির্বাচন ট্রিগারের জন্য কনটেক্সচুয়াল ড্রাইভ ইভেন্ট অবজেক্টের মধ্যে ট্রিগারটি চালু হওয়ার সময় ব্যবহারকারীর নির্বাচিত আইটেমগুলির তথ্য অন্তর্ভুক্ত থাকে। যখন কোনও ব্যবহারকারী ড্রাইভে একাধিক আইটেম নির্বাচন করেন, তখন আইটেমগুলির মধ্যে একটিকে প্রাথমিক আগ্রহের একটি হিসাবে বিবেচনা করা হয়; এই আইটেমটিকে সক্রিয় কার্সার আইটেম হিসাবে উল্লেখ করা হয়।
নিচের উদাহরণে একটি Drive ইভেন্ট অবজেক্ট দেখানো হয়েছে যা 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"
},
...
]
},
...
}