যখন কোনও ব্যবহারকারী কোনও ফাইল তৈরি করে বা খোলে তখন Google Drive-এ আপনার অ্যাপটি প্রদর্শন করতে, আপনাকে প্রথমে একটি Drive ইউজার ইন্টারফেস (UI) ইন্টিগ্রেশন সেট আপ করতে হবে। Google Workspace Marketplace- এ আপনার অ্যাপটি তালিকাভুক্ত করার জন্য কনফিগারেশনও প্রয়োজন।
ড্রাইভ API সক্ষম করুন
Google API ব্যবহার করার আগে, আপনাকে Google Cloud Project-এ সেগুলি চালু করতে হবে। আপনি একটি Google Cloud Project-এ এক বা একাধিক API চালু করতে পারেন।
গুগল ড্রাইভ ইউআই এর সাথে ইন্টিগ্রেট করা শুরু করতে, আপনাকে ড্রাইভ এপিআই সক্ষম করতে হবে। এটি আপনাকে এপিআই এবং ইউআই ইন্টিগ্রেশন বৈশিষ্ট্যগুলিতে অ্যাক্সেস দেবে।
গুগল ক্লাউড কনসোলে, গুগল ড্রাইভ এপিআই সক্ষম করুন।
ড্রাইভ UI ইন্টিগ্রেশন সেট আপ করুন
- গুগল এপিআই কনসোলে, মেনু > এপিআই এবং পরিষেবা > সক্ষম এপিআই এবং পরিষেবাগুলিতে যান।
- APIs & Services ড্যাশবোর্ডের নীচে, Google Drive API এ ক্লিক করুন। Google Drive API কনফিগারেশন পৃষ্ঠাটি প্রদর্শিত হবে।
- ড্রাইভ UI ইন্টিগ্রেশন ট্যাবটি নির্বাচন করুন।
- (ঐচ্ছিক) অ্যাপ্লিকেশনের নাম ক্ষেত্রে একটি নাম লিখুন। ড্রাইভ সেটিংসের "অ্যাপ পরিচালনা করুন" ট্যাবে ব্যবহারকারীদের কাছে অ্যাপ্লিকেশনের নামটি প্রদর্শিত হবে।
- (ঐচ্ছিক) "সংক্ষিপ্ত বিবরণ" ক্ষেত্রে একটি সংক্ষিপ্ত, এক-লাইনের বিবরণ লিখুন। "ড্রাইভ সেটিংস"-এর "অ্যাপ পরিচালনা করুন" ট্যাবে ব্যবহারকারীদের কাছে সংক্ষিপ্ত বিবরণটি প্রদর্শিত হবে।
- (ঐচ্ছিক) দীর্ঘ বিবরণ ক্ষেত্রে একটি সম্পূর্ণ বিবরণ লিখুন।
ব্যবহারকারীর সংযুক্ত ড্রাইভ অ্যাপের তালিকা এবং "এর সাথে খুলুন" প্রসঙ্গ মেনুতে প্রদর্শনের জন্য এক বা একাধিক অ্যাপ্লিকেশন আইকন আপলোড করুন। আইকনগুলি স্বচ্ছ ব্যাকগ্রাউন্ড সহ PNG ফর্ম্যাটে থাকা উচিত। ড্রাইভে আইকনগুলি প্রদর্শিত হতে 24 ঘন্টা পর্যন্ত সময় লাগতে পারে।
ড্রাইভ UI এর "Open with" মেনু আইটেমটি ব্যবহার করতে, Open URL ক্ষেত্রে আপনার অ্যাপের URL লিখুন। এই URLটি "Open With" প্রসঙ্গ মেনু দ্বারা ব্যবহৃত হয়।
- এই URL-এ অবশ্যই একটি সম্পূর্ণ যোগ্য ডোমেইন নাম থাকতে হবে;
localhostকাজ করে না। - এই URL টি আপনার অ্যাপ্লিকেশনের উদ্দেশ্যে ব্যবহারকারীদের কাছে অ্যাক্সেসযোগ্য হওয়া উচিত। যদি আপনার একাধিক অ্যাপ্লিকেশন সংস্করণ থাকে, যেমন একটি সর্বজনীন প্রকাশের জন্য এবং একটি নির্দিষ্ট ব্যবহারকারীদের জন্য সীমাবদ্ধ প্রকাশের জন্য, তাহলে প্রতিটি সংস্করণের একটি অনন্য URL ব্যবহার করা উচিত। তারপরে আপনি প্রতিটি সংস্করণের জন্য আলাদা আলাদা অ্যাপ কনফিগারেশন তৈরি করতে পারেন।
- Google Workspace Marketplace-এ আপনার অ্যাপটি তালিকাভুক্ত করার আগে আপনাকে অবশ্যই এই URL-এর মালিকানা যাচাই করতে হবে।
- ডিফল্টরূপে, ড্রাইভ UI থেকে আপনার অ্যাপে ডেটা প্রেরণের জন্য এই URL-এ একটি
stateকোয়েরি প্যারামিটার যুক্ত করা হয়।stateপ্যারামিটারের বিষয়বস্তু সম্পর্কে তথ্যের জন্য,stateপ্যারামিটার দেখুন।
- এই URL-এ অবশ্যই একটি সম্পূর্ণ যোগ্য ডোমেইন নাম থাকতে হবে;
(ঐচ্ছিক) ডিফল্ট MIME প্রকার এবং ডিফল্ট ফাইল এক্সটেনশন ক্ষেত্রগুলিতে ডিফল্ট MIME প্রকার এবং ফাইল এক্সটেনশন লিখুন। ডিফল্ট MIME প্রকার এবং ফাইল এক্সটেনশনগুলি সেই ফাইলগুলিকে প্রতিনিধিত্ব করে যেগুলি আপনার অ্যাপটি খোলার জন্য অনন্যভাবে তৈরি করা হয়েছে। উদাহরণস্বরূপ, আপনার অ্যাপটি ছবি লেয়ারিং এবং সম্পাদনা করার জন্য একটি অন্তর্নির্মিত ফর্ম্যাট খুলতে পারে। শুধুমাত্র স্ট্যান্ডার্ড মিডিয়া প্রকারগুলি অন্তর্ভুক্ত করুন এবং নিশ্চিত করুন যে সেগুলি টাইপো এবং ভুল বানান মুক্ত। যদি আপনার অ্যাপটি কেবল শর্টকাট বা তৃতীয় পক্ষের শর্টকাট ফাইল খোলে, তাহলে আপনি MIME প্রকারটি ফাঁকা রাখতে পারেন।
(ঐচ্ছিক) সেকেন্ডারি MIME টাইপ এবং সেকেন্ডারি ফাইল এক্সটেনশন ফিল্ডে সেকেন্ডারি MIME টাইপ এবং ফাইল এক্সটেনশন লিখুন। সেকেন্ডারি MIME টাইপ এবং ফাইল এক্সটেনশনগুলি আপনার অ্যাপ খুলতে পারে এমন ফাইলগুলিকে প্রতিনিধিত্ব করে, কিন্তু আপনার অ্যাপের জন্য নির্দিষ্ট নয়। উদাহরণস্বরূপ, আপনার অ্যাপটি একটি ইমেজ-এডিটিং অ্যাপ হতে পারে যা PNG এবং JPG ছবি খোলে। শুধুমাত্র স্ট্যান্ডার্ড মিডিয়া টাইপগুলি অন্তর্ভুক্ত করুন এবং নিশ্চিত করুন যে সেগুলি টাইপিং এবং ভুল বানান মুক্ত। যদি আপনার অ্যাপটি শুধুমাত্র শর্টকাট বা তৃতীয় পক্ষের শর্টকাট ফাইল খোলে, তাহলে আপনি MIME টাইপটি ফাঁকা রাখতে পারেন।
ড্রাইভ UI এর "নতুন" বোতামটি ব্যবহার করতে এবং ব্যবহারকারীদের আপনার অ্যাপ দিয়ে একটি ফাইল তৈরি করতে, "ফাইল তৈরি করা" বাক্সটি চেক করুন। নতুন URL এবং ঐচ্ছিক ডকুমেন্টের নাম ক্ষেত্রগুলি প্রদর্শিত হবে।
- এই URL-এ অবশ্যই একটি সম্পূর্ণ যোগ্য ডোমেইন নাম থাকতে হবে;
localhostকাজ করে না। - Google Workspace Marketplace-এ আপনার অ্যাপটি তালিকাভুক্ত করার আগে আপনাকে অবশ্যই এই URL-এর মালিকানা যাচাই করতে হবে।
- ডিফল্টরূপে, ড্রাইভ UI থেকে আপনার অ্যাপে ডেটা প্রেরণের জন্য এই URL-এ একটি
stateকোয়েরি প্যারামিটার যুক্ত করা হয়।stateপ্যারামিটারের বিষয়বস্তু সম্পর্কে তথ্যের জন্য,stateপ্যারামিটার দেখুন।
- এই URL-এ অবশ্যই একটি সম্পূর্ণ যোগ্য ডোমেইন নাম থাকতে হবে;
নতুন URL ক্ষেত্রে একটি URL লিখুন। ব্যবহারকারীকে আপনার অ্যাপ্লিকেশনে পুনঃনির্দেশিত করতে "নতুন" বোতামটি এই URL ব্যবহার করে।
(ঐচ্ছিক) যদি আপনি চান যে আপনার অ্যাপটি Google Workspace-সমর্থিত ফাইলগুলি খুলুক, তাহলে Importing বাক্সটি চেক করুন।
(ঐচ্ছিক) যদি আপনার অ্যাপকে শেয়ার্ড ড্রাইভে ফাইল পরিচালনা করতে হয়, তাহলে শেয়ার্ড ড্রাইভ সাপোর্ট বক্সটি চেক করুন। আপনার অ্যাপে শেয়ার্ড ড্রাইভ কীভাবে সাপোর্ট করবেন সে সম্পর্কে আরও তথ্যের জন্য, শেয়ার্ড ড্রাইভ সাপোর্ট বাস্তবায়ন দেখুন।
জমা দিন ক্লিক করুন।
drive.install স্কোপ অনুরোধ করুন
"Open with" অথবা "New" মেনুতে অ্যাপগুলিকে একটি বিকল্প হিসেবে প্রদর্শিত হতে দেওয়ার জন্য, https://www.googleapis.com/auth/drive.install স্কোপটিকে ড্রাইভ UI এর সাথে একীভূত করার অনুরোধ করুন। এই স্কোপটির অনুরোধ করার সময়, ব্যবহারকারীরা এই ধরণের একটি ডায়ালগ পাবেন:

ড্রাইভ অ্যাপের জন্য আপনি যে স্কোপগুলির অনুরোধ করতে পারেন এবং কীভাবে সেগুলির অনুরোধ করবেন সে সম্পর্কে আরও তথ্যের জন্য, API-নির্দিষ্ট অনুমোদন এবং প্রমাণীকরণ তথ্য দেখুন।
state প্যারামিটার
ডিফল্টরূপে, ড্রাইভ UI থেকে আপনার অ্যাপে ডেটা প্রেরণের জন্য ওপেন URL এবং নিউ URL উভয়ের সাথে একটি state প্যারামিটার যুক্ত করা হয়। এই প্যারামিটারে টেমপ্লেট ভেরিয়েবল এবং আপনার অ্যাপে অনুরোধ সম্পর্কে ডেটা সহ একটি JSON-এনকোডেড স্ট্রিং রয়েছে। অন্তর্ভুক্ত ভেরিয়েবলগুলি ব্যবহৃত URL এর ধরণের উপর নির্ভর করে (ওপেন URL বা নিউ URL):
| টেমপ্লেট ভেরিয়েবল | বিবরণ | URL অ্যাপ্লিকেশন |
|---|---|---|
{ids} | ফাইল আইডিগুলির একটি কমা দ্বারা পৃথক তালিকা খোলা হচ্ছে। | URL খুলুন |
{exportIds} | এক্সপোর্ট করা ফাইল আইডিগুলির একটি কমা দ্বারা পৃথক তালিকা। শুধুমাত্র Google Workspace ফাইল খোলার সময় ব্যবহৃত হয়। | URL খুলুন |
{resourceKeys} | ফাইল আইডিগুলির একটি JSON অভিধান যা তাদের নিজ নিজ রিসোর্স কীগুলিতে ম্যাপ করা হয়েছে। | URL খুলুন |
{folderId} | মূল ফোল্ডারের আইডি। | নতুন URL |
{folderResourceKey} | মূল ফোল্ডারের রিসোর্স কী। | নতুন URL |
{userId} | ব্যবহারকারীকে শনাক্তকারী প্রোফাইল আইডি। | URL এবং নতুন URL খুলুন |
{action} | যে কাজটি করা হচ্ছে। একটি ওপেন URL ব্যবহার করার সময় মানটি open থাকে অথবা একটি নতুন URL ব্যবহার করার সময় create । | URL এবং নতুন URL খুলুন |
state প্যারামিটারটি URL-এনকোডেড, তাই আপনার অ্যাপটিকে অবশ্যই এস্কেপ ক্যারেক্টারগুলি পরিচালনা করতে হবে এবং এটিকে JSON হিসেবে পার্স করতে হবে। ফাইল তৈরির অনুরোধ যাচাই করার জন্য অ্যাপগুলি state প্যারামিটারে create মান সনাক্ত করতে পারে।
একটি নতুন URL-এর জন্য JSON-এ স্থিতির তথ্যের উদাহরণ
একটি নতুন URL-এর state তথ্য হল:
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
একটি ওপেন URL-এর জন্য JSON-এ স্থিতির তথ্যের উদাহরণ
একটি ওপেন URL-এর state তথ্য হল:
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
ফাইল মেটাডেটা আনতে এবং ফাইলের কন্টেন্ট ডাউনলোড করতে আইডি এবং রিসোর্স কী ব্যবহার করা হয়। একবার আপনার অ্যাপে ফাইল আইডি এবং অ্যাক্সেস টোকেন থাকলে, এটি অনুমতি পরীক্ষা করতে পারে, ফাইলের মেটাডেটা আনতে পারে এবং files.get পদ্ধতিতে বর্ণিত ফাইলের কন্টেন্ট ডাউনলোড করতে পারে।
সম্পর্কিত বিষয়
একটি ইনস্টল করা অ্যাপকে অবশ্যই ড্রাইভ UI থেকে চালু হওয়া অ্যাকশন তৈরি, পরিচালনা এবং খুলতে সক্ষম হতে হবে। আরও জানতে, ড্রাইভ UI এর "নতুন" বোতামের সাথে ইন্টিগ্রেট করুন অথবা ড্রাইভ UI এর "ওপেন উইথ" প্রসঙ্গ মেনুতে ইন্টিগ্রেট করুন দেখুন।