যখন একজন ব্যবহারকারী একটি ফাইল নির্বাচন করেন এবং ড্রাইভ UI-এর "ওপেন উইথ" মেনু আইটেমটিতে ক্লিক করেন, তখন ড্রাইভ ব্যবহারকারীকে সেই অ্যাপের ওপেন URL-এ সংজ্ঞায়িত করে যা একটি ড্রাইভ UI ইন্টিগ্রেশন কনফিগার করুন ।
আপনি একটি ড্রাইভ UI ইন্টিগ্রেশন কনফিগার করার সময় "আমদানি করা" বাক্সে টিক চিহ্ন দিয়ে থাকলে, ব্যবহারকারী অ্যাপ-নির্দিষ্ট এবং Google Workspace ফাইল খোলার জন্য একটি সমন্বয় নির্বাচন করতে পারেন। আপনি যখন একটি ড্রাইভ UI ইন্টিগ্রেশন কনফিগার করেন, তখন অ্যাপ-নির্দিষ্ট ফাইলগুলিকে "ডিফল্ট MIME প্রকার" এবং "ডিফল্ট ফাইল এক্সটেনশন" ফিল্ডে সংজ্ঞায়িত করা হয়, যেখানে Google Workspace ফাইলগুলি "সেকেন্ডারি MIME প্রকার" এবং "সেকেন্ডারি ফাইল এক্সটেনশন" ফিল্ডে সংজ্ঞায়িত করা হয়।
ব্যবহারকারী খুলতে চায় এমন প্রতিটি ফাইলের জন্য, ড্রাইভ আপনার সংজ্ঞায়িত ডিফল্ট এবং সেকেন্ডারি MIME প্রকারগুলির বিপরীতে MIME প্রকারগুলি পরীক্ষা করে:
"ডিফল্ট MIME প্রকার" ক্ষেত্রে সংজ্ঞায়িত MIME প্রকারের জন্য, ফাইল আইডি আপনার অ্যাপে পাঠানো হয়। অ্যাপ-নির্দিষ্ট ফাইলগুলি কীভাবে পরিচালনা করবেন সে সম্পর্কে তথ্যের জন্য, অ্যাপ-নির্দিষ্ট নথিগুলির জন্য একটি খোলা URL হ্যান্ডেল দেখুন।
"সেকেন্ডারি MIME প্রকার" ফিল্ডে সংজ্ঞায়িত MIME প্রকারের জন্য, ড্রাইভ UI একটি ডায়ালগ প্রদর্শন করে যা ব্যবহারকারীকে জিজ্ঞাসা করে যে Google Workspace ফাইলকে কোন ধরনের ফাইলে রূপান্তর করতে হবে। উদাহরণ স্বরূপ, আপনি যদি ড্রাইভ UI-এ একটি Google ডক্স ফাইল নির্বাচন করেন এবং "সেকেন্ডারি MIME প্রকার" ক্ষেত্রে আপনার অ্যাপটি টেক্সট/প্লেইন বা অ্যাপ্লিকেশন/পিডিএফ সমর্থন করে, তাহলে ড্রাইভ UI ব্যবহারকারীকে জিজ্ঞাসা করে যে তারা প্লেইন টেক্সট বা পিডিএফ-এ রূপান্তর করতে চান কিনা। .
Google Workspace ফাইলগুলি কীভাবে পরিচালনা করবেন সে সম্পর্কে তথ্যের জন্য, Google Workspace ডকুমেন্টের জন্য একটি খোলা URL হ্যান্ডেল দেখুন। Google Workspace ডকুমেন্ট এবং MIME টাইপ কনভার্সন ফর্ম্যাটের তালিকার জন্য, Google Workspace ডকুমেন্টের জন্য MIME প্রকার এক্সপোর্ট দেখুন।
অ্যাপ-নির্দিষ্ট নথিগুলির জন্য একটি ওপেন URL পরিচালনা করুন
একটি ড্রাইভ 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
প্যারামিটারটি ইউআরএল-এনকোডেড, তাই আপনার অ্যাপকে অবশ্যই এস্কেপ অক্ষরগুলি পরিচালনা করতে হবে এবং এটি JSON হিসাবে পার্স করতে হবে।
Google Workspace ডকুমেন্টের জন্য একটি ওপেন ইউআরএল পরিচালনা করুন
একটি ড্রাইভ UI ইন্টিগ্রেশন কনফিগার করুন এ উল্লিখিত হিসাবে, আপনার অ্যাপ একটি state
প্যারামিটারের মধ্যে টেমপ্লেট ভেরিয়েবলের একটি ডিফল্ট সেট পায়৷ Google Workspace Open URL-এর জন্য ডিফল্ট state
তথ্য হল:
{
"exportIds": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
এই আউটপুট নিম্নলিখিত মান অন্তর্ভুক্ত:
- EXPORT_ID : রপ্তানি করা ফাইল আইডিগুলির একটি কমা দ্বারা পৃথক করা তালিকা (শুধুমাত্র অন্তর্নির্মিত Google নথি খোলার সময় ব্যবহৃত হয়)।
- 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
অনুরোধ শিরোনাম সেট করুন। রিসোর্স কী সম্পর্কে আরও তথ্যের জন্য, রিসোর্স কী ব্যবহার করে লিঙ্ক-ভাগ করা ফাইল অ্যাক্সেস করুন দেখুন।জাভা
পাইথন
Node.js
পিএইচপি
রূপান্তরিত ফাইলগুলিকে শুধুমাত্র পঠনযোগ্য হিসাবে প্রদর্শন করুন বা ব্যবহারকারীকে ফাইলটিকে নতুন ফাইলের ধরণ হিসাবে সংরক্ষণ করতে দিয়ে একটি ডায়ালগ উপস্থাপন করুন।
state
প্যারামিটারটি ইউআরএল-এনকোডেড, তাই আপনার অ্যাপকে অবশ্যই এস্কেপ অক্ষরগুলি পরিচালনা করতে হবে এবং এটি JSON হিসাবে পার্স করতে হবে।
ব্যবহারকারী এবং নতুন ইভেন্ট
ড্রাইভ অ্যাপ্লিকেশানগুলিকে সম্ভাব্য সাইন-ইন হিসাবে সমস্ত "ওপেন উইথ" ইভেন্ট বিবেচনা করা উচিত৷ কিছু ব্যবহারকারীর একাধিক অ্যাকাউন্ট থাকতে পারে, তাই state
প্যারামিটারে ব্যবহারকারী আইডি বর্তমান সেশনের সাথে নাও মিলতে পারে। যদি state
প্যারামিটারের ব্যবহারকারী আইডি বর্তমান সেশনের সাথে মেলে না, তাহলে আপনার অ্যাপের বর্তমান সেশনটি শেষ করুন এবং অনুরোধ করা ব্যবহারকারী হিসেবে সাইন ইন করুন।
সম্পর্কিত বিষয়
গুগল ড্রাইভ UI থেকে একটি অ্যাপ্লিকেশন খোলার পাশাপাশি, অ্যাপ্লিকেশনগুলি একটি অ্যাপের মধ্যে থেকে সামগ্রী নির্বাচন করতে একটি ফাইল পিকার প্রদর্শন করতে পারে। আরও তথ্যের জন্য, Google পিকার দেখুন।