যখন একজন ব্যবহারকারী একটি ফাইল নির্বাচন করে এবং Drive UI এর "Open with" মেনু আইটেমে ক্লিক করে, তখন Drive ব্যবহারকারীকে Configure a Drive UI ইন্টিগ্রেশনে সংজ্ঞায়িত সেই অ্যাপের Open URL-এ পুনঃনির্দেশিত করে।
যদি আপনি ড্রাইভ UI ইন্টিগ্রেশন কনফিগার করার সময় "আমদানি" বাক্সটি চেক করে থাকেন, তাহলে ব্যবহারকারী খোলার জন্য অ্যাপ-নির্দিষ্ট এবং Google Workspace ফাইলের সংমিশ্রণ নির্বাচন করতে পারেন। যখন আপনি একটি ড্রাইভ UI ইন্টিগ্রেশন কনফিগার করেন, তখন অ্যাপ-নির্দিষ্ট ফাইলগুলি "ডিফল্ট MIME প্রকার" এবং "ডিফল্ট ফাইল এক্সটেনশন" ক্ষেত্রে সংজ্ঞায়িত করা হয়, যেখানে Google Workspace ফাইলগুলি "সেকেন্ডারি MIME প্রকার" এবং "সেকেন্ডারি ফাইল এক্সটেনশন" ক্ষেত্রে সংজ্ঞায়িত করা হয়।
ব্যবহারকারী যে প্রতিটি ফাইল খুলতে চান, তার জন্য ড্রাইভ আপনার নির্ধারিত ডিফল্ট এবং সেকেন্ডারি MIME প্রকারের সাথে MIME প্রকারগুলি পরীক্ষা করে:
"ডিফল্ট MIME প্রকার" ক্ষেত্রে সংজ্ঞায়িত MIME প্রকারের জন্য, ফাইল আইডি আপনার অ্যাপে পাঠানো হয়। অ্যাপ-নির্দিষ্ট ফাইলগুলি কীভাবে পরিচালনা করবেন সে সম্পর্কে তথ্যের জন্য, "অ্যাপ-নির্দিষ্ট নথির জন্য একটি খোলা URL পরিচালনা করুন" দেখুন।
"সেকেন্ডারি MIME টাইপস" ফিল্ডে সংজ্ঞায়িত MIME টাইপের জন্য, ড্রাইভ UI একটি ডায়ালগ প্রদর্শন করে যেখানে ব্যবহারকারীকে জিজ্ঞাসা করা হয় যে Google Workspace ফাইলটি কোন ধরণের ফাইলে রূপান্তর করতে হবে। উদাহরণস্বরূপ, যদি আপনি ড্রাইভ UI তে একটি Google Docs ফাইল নির্বাচন করেন এবং "সেকেন্ডারি MIME টাইপস" ফিল্ডটি আপনার অ্যাপটি টেক্সট/প্লেইন বা অ্যাপ্লিকেশন/পিডিএফ সমর্থন করে বলে মনে করে, তাহলে ড্রাইভ UI ব্যবহারকারীকে জিজ্ঞাসা করে যে তারা প্লেইন টেক্সট বা পিডিএফে রূপান্তর করতে চান কিনা।
Google Workspace ফাইলগুলি কীভাবে পরিচালনা করবেন সে সম্পর্কে তথ্যের জন্য, Google Workspace ডকুমেন্টগুলির জন্য একটি খোলা URL পরিচালনা করুন দেখুন। Google Workspace ডকুমেন্ট এবং MIME টাইপ রূপান্তর ফর্ম্যাটের তালিকার জন্য, Google Workspace ডকুমেন্টগুলির জন্য MIME টাইপগুলি রপ্তানি করুন দেখুন।
অ্যাপ-নির্দিষ্ট নথির জন্য একটি ওপেন URL পরিচালনা করুন
যেমনটি "Configure a Drive UI integration" বিভাগে উল্লেখ করা হয়েছে, আপনার অ্যাপটি ফাইলটি খোলার জন্য তথ্য সহ টেমপ্লেট ভেরিয়েবল গ্রহণ করে। আপনার অ্যাপটি একটি 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 ডকুমেন্টের জন্য একটি Open URL পরিচালনা করুন
Configure a Drive UI ইন্টিগ্রেশনে উল্লেখ করা হয়েছে, আপনার অ্যাপটি একটি state
প্যারামিটারের মধ্যে টেমপ্লেট ভেরিয়েবলের একটি ডিফল্ট সেট পায়। একটি Google Workspace Open URL এর জন্য ডিফল্ট state
তথ্য হল:
{
"exportIds": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS&
quot;},
"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
পদ্ধতি ব্যবহার করে ফাইলের বিষয়বস্তু রূপান্তর করুন। নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি Google Workspace ডকুমেন্ট অনুরোধকৃত MIME টাইপে রপ্তানি করতে হয়।যদি অনুরোধে
resourceKey
সেট করা থাকে,X-Goog-Drive-Resource-Keys
অনুরোধ শিরোনাম সেট করুন। রিসোর্স কী সম্পর্কে আরও তথ্যের জন্য, রিসোর্স কী ব্যবহার করে লিঙ্ক-শেয়ার করা ফাইলগুলি অ্যাক্সেস করুন দেখুন।জাভা
পাইথন
নোড.জেএস
পিএইচপি
রূপান্তরিত ফাইলগুলিকে কেবল-পঠনযোগ্য হিসাবে প্রদর্শন করুন অথবা ব্যবহারকারীকে নতুন ফাইল টাইপ হিসাবে ফাইলটি সংরক্ষণ করার জন্য একটি ডায়ালগ উপস্থাপন করুন।
state
প্যারামিটারটি URL-এনকোডেড, তাই আপনার অ্যাপটিকে অবশ্যই এস্কেপ ক্যারেক্টারগুলি পরিচালনা করতে হবে এবং JSON হিসাবে পার্স করতে হবে।
ব্যবহারকারী এবং নতুন ইভেন্ট
ড্রাইভ অ্যাপগুলির উচিত সমস্ত "ওপেন উইথ" ইভেন্টগুলিকে সম্ভাব্য সাইন-ইন হিসাবে বিবেচনা করা। কিছু ব্যবহারকারীর একাধিক অ্যাকাউন্ট থাকতে পারে, তাই state
প্যারামিটারে থাকা ব্যবহারকারী আইডি বর্তমান সেশনের সাথে নাও মিলতে পারে। যদি state
প্যারামিটারে থাকা ব্যবহারকারী আইডি বর্তমান সেশনের সাথে না মেলে, তাহলে আপনার অ্যাপের জন্য বর্তমান সেশনটি শেষ করুন এবং অনুরোধকৃত ব্যবহারকারী হিসাবে সাইন ইন করুন।
সম্পর্কিত বিষয়
গুগল ড্রাইভ ইউআই থেকে অ্যাপ্লিকেশন খোলার পাশাপাশি, অ্যাপ্লিকেশনগুলি একটি অ্যাপের মধ্যে থেকে সামগ্রী নির্বাচন করার জন্য একটি ফাইল পিকার প্রদর্শন করতে পারে। আরও তথ্যের জন্য, গুগল পিকার দেখুন।