ব্যবহারকারী কোনও ফাইল বেছে নিয়ে Drive UI-এর "এতে খুলুন " মেনু আইটেমে ক্লিক করলে, Drive ব্যবহারকারীকে Drive UI ইন্টিগ্রেশন কনফিগার করুন বিকল্পে উল্লেখ করা অ্যাপের 'URL খুলুন' বিকল্পে রিডাইরেক্ট করে।
Drive UI ইন্টিগ্রেশন কনফিগার করার সময় আপনি "ইমপোর্ট করা হচ্ছে" বক্সে টিকচিহ্ন দিয়ে থাকলে, ব্যবহারকারী খোলার জন্য অ্যাপ-নির্দিষ্ট এবং Google Workspace ফাইলের একটি কম্বিনেশন বেছে নিতে পারবেন। আপনি যখন Drive UI ইন্টিগ্রেশন কনফিগার করেন, তখন অ্যাপ-নির্দিষ্ট ফাইলগুলি "ডিফল্ট MIME প্রকার" এবং "ডিফল্ট ফাইল এক্সটেনশন" ফিল্ডে সংজ্ঞায়িত করা হয়, যেখানে Google Workspace ফাইলগুলি "সেকেন্ডারি MIME প্রকার" এবং "সেকেন্ডারি ফাইল এক্সটেনশন" ফিল্ডে সংজ্ঞায়িত করা হয়।
ব্যবহারকারী যে ফাইল খুলতে চান, Drive সেটির MIME টাইপ আপনার নির্ধারিত ডিফল্ট ও সেকেন্ডারি MIME টাইপের সাথে মিলিয়ে দেখে:
"ডিফল্ট MIME-এর প্রকার" ফিল্ডে উল্লেখ করা MIME-এর প্রকারের জন্য, ফাইল আইডি আপনার অ্যাপে পাঠানো হয়। অ্যাপ-নির্দিষ্ট ফাইল কীভাবে ম্যানেজ করতে হয় সেই সম্পর্কে তথ্যের জন্য, অ্যাপ-নির্দিষ্ট ডকুমেন্টের জন্য একটি ওপেন URL ম্যানেজ করুন দেখুন।
"সেকেন্ডারি MIME-এর প্রকার" ফিল্ডে উল্লেখ করা MIME-এর প্রকারের জন্য, Drive UI একটি ডায়ালগ দেখায় যেখানে ব্যবহারকারীকে জিজ্ঞাসা করা হয় যে Google Workspace ফাইলটি কোন ফাইলের প্রকারে পরিবর্তন করতে হবে। যেমন, আপনি Drive UI-তে কোনও Google Docs ফাইল বেছে নিলে এবং "সেকেন্ডারি MIME-এর প্রকার" ফিল্ডে আপনার অ্যাপ text/plain বা application/pdf সাপোর্ট করে বলে সাজেস্ট করলে, Drive UI ব্যবহারকারীকে জিজ্ঞাসা করে যে তিনি প্লেন টেক্সট বা PDF-এ কনভার্ট করতে চান কিনা।
Google Workspace ফাইল কীভাবে ম্যানেজ করতে হয় সেই সম্পর্কে জানতে, Google Workspace ডকুমেন্টের জন্য Open URL ম্যানেজ করুন নিবন্ধটি দেখুন। Google Workspace ডকুমেন্ট এবং MIME টাইপ কনভার্সন ফর্ম্যাটের তালিকার জন্য, Google Workspace ডকুমেন্টের জন্য MIME টাইপ এক্সপোর্ট করুন দেখুন।
অ্যাপ-নির্দিষ্ট ডকুমেন্টের জন্য একটি খোলা URL ম্যানেজ করুন
Drive UI ইন্টিগ্রেশন কনফিগার করুন
লিঙ্কে যেমন উল্লেখ করা আছে,
আপনার অ্যাপ ফাইল খোলার জন্য প্রয়োজনীয় তথ্য সহ টেমপ্লেট ভেরিয়েবল
পায়। আপনার অ্যাপ state প্যারামিটারের মধ্যে
টেমপ্লেট ভেরিয়েবলের ডিফল্ট সেট পায়। অ্যাপ-নির্দিষ্ট URL খোলার জন্য ডিফল্ট state তথ্য হল:
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
এই আউটপুটে নিম্নলিখিত ভ্যালু অন্তর্ভুক্ত থাকে:
- ID: পেরেন্ট ফোল্ডারের আইডি।
- RESOURCE_KEYS: ফাইল আইডির JSON ডিকশনারি যা সংশ্লিষ্ট রিসোর্স কীতে ম্যাপ করা আছে।
open: যে অ্যাকশন পারফর্ম করা হচ্ছে। Open URL ব্যবহার করার সময় ভ্যালু হলopen।- USER_ID: প্রোফাইল আইডি যা ব্যবহারকারীকে অনন্যভাবে শনাক্ত করে।
আপনার অ্যাপকে এইসব ধাপ অনুসরণ করে এই অনুরোধের উপর কাজ করতে হবে:
actionফিল্ডেopenভ্যালু আছে কিনা এবংidsফিল্ড আছে কিনা তা যাচাই করুন।- ব্যবহারকারীর জন্য নতুন সেশন তৈরি করতে
userIdভ্যালু ব্যবহার করুন। সাইন-ইন করা ব্যবহারকারীদের সম্পর্কে আরও জানতে, ব্যবহারকারী ও নতুন ইভেন্ট দেখুন। IDভ্যালু ব্যবহার করে অনুমতি চেক করতে, ফাইল মেটাডেটা ফেচ করতে এবং ফাইলের কন্টেন্ট ডাউনলোড করতেfiles.getপদ্ধতি ব্যবহার করুন।- অনুরোধে
resourceKeysসেট করা থাকলে,X-Goog-Drive-Resource-Keysঅনুরোধ হেডার সেট করুন। রিসোর্স কী সম্পর্কে আরও জানতে, রিসোর্স কী ব্যবহার করে লিঙ্ক-শেয়ার করা ফাইল অ্যাক্সেস করুন নিবন্ধটি দেখুন।
state প্যারামিটারটি URL-এনকোড করা, তাই আপনার অ্যাপকে অবশ্যই এস্কেপ ক্যারেক্টার
ম্যানেজ করতে হবে এবং JSON হিসেবে পার্স করতে হবে।
Google Workspace ডকুমেন্টের জন্য একটি ওপেন URL ম্যানেজ করুন
Drive UI ইন্টিগ্রেশন কনফিগার করুন বিভাগে যেমন উল্লেখ করা হয়েছে, আপনার অ্যাপ state প্যারামিটারের মধ্যে টেমপ্লেট ভেরিয়েবলের ডিফল্ট সেট পায়। Google Workspace Open URL-এর জন্য
ডিফল্ট state তথ্য হল:
{
"exportIds": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
এই আউটপুটে নিম্নলিখিত ভ্যালু অন্তর্ভুক্ত থাকে:
- EXPORT_ID: এক্সপোর্ট করা হচ্ছে এমন ফাইল আইডির কমা দ্বারা আলাদা করা তালিকা। শুধুমাত্র Google Workspace ফাইল খোলার সময় ব্যবহার করা হয়।
- RESOURCE_KEYS: ফাইল আইডির JSON ডিকশনারি যা সংশ্লিষ্ট রিসোর্স কীতে ম্যাপ করা আছে।
open: যে অ্যাকশন পারফর্ম করা হচ্ছে। Open URL ব্যবহার করার সময় ভ্যালু হলopen।- USER_ID: প্রোফাইল আইডি যা ব্যবহারকারীকে শনাক্ত করে।
আপনার অ্যাপকে এইসব ধাপ অনুসরণ করে এই অনুরোধের উপর কাজ করতে হবে:
stateফিল্ডেopenভ্যালু এবংexportIdsফিল্ডের উপস্থিতি শনাক্ত করে যাচাই করুন যে এটি ফাইল খোলার অনুরোধ কিনা।EXPORT_IDভ্যালু ব্যবহার করে অনুমতি চেক করতে, ফাইল মেটাডেটা ফেচ করতে এবং MIME-এর ধরন নির্ধারণ করতেfiles.getপদ্ধতি ব্যবহার করুন।files.exportপদ্ধতি ব্যবহার করে ফাইলের কন্টেন্ট কনভার্ট করুন। নিম্নলিখিত কোড স্যাম্পেল দেখায় যে কীভাবে অনুরোধ করা MIME-এর প্রকার অনুযায়ী Google Workspace ডকুমেন্ট এক্সপোর্ট করতে হয়।অনুরোধে
resourceKeyসেট করা থাকলে,X-Goog-Drive-Resource-Keysঅনুরোধ হেডার সেট করুন। রিসোর্স কী সম্পর্কে আরও জানতে, রিসোর্স কী ব্যবহার করে লিঙ্ক-শেয়ার করা ফাইল অ্যাক্সেস করুন নিবন্ধটি দেখুন।Java
Python
Node.js
PHP
কনভার্ট করা ফাইল শুধু-পড়ার-জন্য হিসেবে দেখান অথবা একটি ডায়ালগ দেখান যা ব্যবহারকারীকে নতুন ফাইলের ধরন হিসেবে ফাইলটি সেভ করতে দেয়।
state প্যারামিটারটি URL-এনকোড করা, তাই আপনার অ্যাপকে অবশ্যই এস্কেপ ক্যারেক্টার
ম্যানেজ করতে হবে এবং JSON হিসেবে পার্স করতে হবে।
ব্যবহারকারী ও নতুন ইভেন্ট
Drive অ্যাপের সব "এর মাধ্যমে খুলুন" ইভেন্টকে সম্ভাব্য সাইন-ইন হিসেবে
বিবেচনা করা উচিত। কিছু ব্যবহারকারীর একাধিক অ্যাকাউন্ট থাকতে পারে, তাই state
প্যারামিটারে ব্যবহারকারীর আইডি বর্তমান সেশনের সাথে নাও মিলতে পারে। state
প্যারামিটারে ব্যবহারকারীর আইডি বর্তমান সেশনের সাথে ম্যাচ না করলে, আপনার অ্যাপের জন্য বর্তমান সেশন শেষ করুন এবং অনুরোধ করা ব্যবহারকারী হিসেবে সাইন-ইন করুন।
সম্পর্কিত বিষয়
Google Drive UI থেকে কোনও অ্যাপ্লিকেশন খোলার পাশাপাশি, অ্যাপ্লিকেশনগুলি কোনও অ্যাপের মধ্যে থেকে কন্টেন্ট বেছে নেওয়ার জন্য ফাইল পিকার দেখাতে পারে। আরও তথ্যের জন্য, Google Picker দেখুন।