Drive UI ইন্টিগ্রেশন কনফিগার করা

কোনও ব্যবহারকারী ফাইল তৈরি করলে বা খুললে, Google Drive-এ আপনার অ্যাপ দেখাতে, আপনাকে প্রথমে Drive ইউজার ইন্টারফেস (UI) ইন্টিগ্রেশন সেট-আপ করতে হবে। Google Workspace Marketplace-এ আপনার অ্যাপ তালিকাভুক্ত করার জন্য কনফিগারেশনও প্রয়োজন।

Drive API চালু করুন

Google APIs ব্যবহার করার আগে, আপনাকে অবশ্যই Google Cloud প্রোজেক্টে সেগুলি চালু করতে হবে। আপনি একটি Google Cloud প্রোজেক্টে এক বা একাধিক API চালু করতে পারবেন।

Google Drive UI-এর সাথে ইন্টিগ্রেট করা শুরু করতে, আপনাকে অবশ্যই Drive API চালু করতে হবে। এটি আপনাকে API এবং UI ইন্টিগ্রেশন ফিচার অ্যাক্সেস করার সুবিধা দেয়।

• Google Cloud কনসোলে, Google Drive API চালু করুন।

  API চালু করুন

Drive UI ইন্টিগ্রেশন সেট-আপ করা

1. Google API কনসোলে, 'মেনু > API ও পরিষেবা > চালু থাকা API ও পরিষেবা' বিকল্পে যান।

   চালু করা API ও পরিষেবা বিকল্পে যান

2. API ও পরিষেবা ড্যাশবোর্ডের নিচে, Google Drive API বিকল্পে ক্লিক করুন। Google Drive API কনফিগারেশন পৃষ্ঠা দেখতে পাবেন।
3. Drive UI ইন্টিগ্রেশন ট্যাব বেছে নিন।
4. (ঐচ্ছিক) অ্যাপ্লিকেশনের নাম ফিল্ডে একটি নাম লিখুন। Drive সেটিংসের 'অ্যাপ ম্যানেজ করুন' ট্যাবে ব্যবহারকারীদের কাছে অ্যাপ্লিকেশনের নাম দেখানো হয়।
5. (ঐচ্ছিক) সংক্ষিপ্ত বিবরণ ফিল্ডে এক লাইনের সংক্ষিপ্ত বিবরণ লিখুন। Drive সেটিংসের 'অ্যাপ ম্যানেজ করুন' ট্যাবে ব্যবহারকারীদের জন্য সংক্ষিপ্ত বিবরণ দেখানো হয়।
6. (ঐচ্ছিক) বিশদ বিবরণ ফিল্ডে সম্পূর্ণ বিবরণ লিখুন।

7. ব্যবহারকারীর কানেক্ট করা Drive অ্যাপের তালিকা এবং "এর মাধ্যমে খুলুন" প্রাসঙ্গিক মেনুতে দেখানোর জন্য এক বা একাধিক অ্যাপ্লিকেশন আইকন আপলোড করুন। আইকন PNG ফর্ম্যাটে ও ট্রান্সপারেন্ট ব্যাকগ্রাউন্ডে হতে হবে। Drive-এ আইকন দেখাতে ২৪ ঘণ্টা পর্যন্ত সময় লাগতে পারে।

   মনে রাখবেন: ডকুমেন্ট আইকন বন্ধ হয়ে গেছে। শর্টকাট ও থার্ড-পার্টি শর্টকাট ফাইলের পাশে আপনার অ্যাপ্লিকেশনের আইকন দেখা যায়। অন্যান্য ফাইলের ধরনের জন্য স্ট্যান্ডার্ড আইকনের সেট ব্যবহার করা হয়।

8. Drive UI-এর "এর মাধ্যমে খুলুন" মেনু আইটেম ব্যবহার করতে, URL খুলুন ফিল্ডে আপনার অ্যাপের URL লিখুন। "এর মাধ্যমে খুলুন" সংশ্লিষ্ট মেনু এই URL ব্যবহার করে।

   • এই URL-এ অবশ্যই সম্পূর্ণভাবে উপযুক্ত ডোমেনের নাম (FQDN) থাকতে হবে; localhost কাজ করে না।
   • আপনার অ্যাপ্লিকেশনের উদ্দিষ্ট ব্যবহারকারীদের জন্য এই URL অ্যাক্সেসযোগ্য হতে হবে। আপনার কাছে একাধিক অ্যাপ্লিকেশন ভার্সন থাকলে, যেমন একটি সর্বজনীন রিলিজের জন্য এবং একটি বাছাই করা ব্যবহারকারীদের জন্য সীমিত রিলিজের জন্য, প্রতিটি ভার্সনের একটি অনন্য URL ব্যবহার করা উচিত। আপনি প্রতিটি ভার্সনের জন্য আলাদা আলাদা অ্যাপ কনফিগারেশন তৈরি করতে পারবেন।
   • Google Workspace Marketplace-এ আপনার অ্যাপ তালিকাভুক্ত করার আগে আপনাকে অবশ্যই এই URL-এর মালিকানা যাচাই করতে হবে।
   • ডিফল্ট হিসেবে, Drive UI থেকে আপনার অ্যাপে ডেটা পাস করার জন্য এই URL-এ একটি state কোয়েরি প্যারামিটার যোগ করা হয়। state প্যারামিটারের কন্টেন্ট সম্পর্কে তথ্যের জন্য, state প্যারামিটার দেখুন।
   সতর্কতা: OAuth 2.0 সম্মতি স্ক্রিন অটোমেটিক দেখানোর বিকল্পটি বন্ধ করা হয়েছে। এই বক্সে টিকচিহ্ন দেবেন না। অ্যাপ্লিকেশনকে অবশ্যই সব অনুমোদনের অনুরোধ শুরু করতে হবে।

9. (ঐচ্ছিক) ডিফল্ট MIME-এর প্রকার এবং ডিফল্ট ফাইল এক্সটেনশন ফিল্ডে ডিফল্ট MIME-এর প্রকার এবং ফাইল এক্সটেনশন লিখুন। ডিফল্ট MIME-এর প্রকার এবং ফাইল এক্সটেনশন সেইসব ফাইলকে দেখায় যেগুলি খোলার জন্য আপনার অ্যাপ বিশেষভাবে তৈরি করা হয়েছে। যেমন, আপনার অ্যাপ, লেয়ারিং ও ছবি এডিট করার জন্য বিল্ট-ইন ফর্ম্যাট খুলতে পারে। শুধুমাত্র স্ট্যান্ডার্ড মিডিয়া টাইপ অন্তর্ভুক্ত করুন এবং নিশ্চিত করুন যে সেগুলিতে কোনও টাইপো এবং বানান ভুল নেই। আপনার অ্যাপ যদি শুধু শর্টকাট বা থার্ড-পার্টি শর্টকাট ফাইল খোলে, তাহলে MIME-এর প্রকার ফাঁকা রাখতে পারেন।

10. (ঐচ্ছিক) সেকেন্ডারি MIME-এর প্রকার এবং সেকেন্ডারি ফাইল এক্সটেনশন ফিল্ডে সেকেন্ডারি MIME-এর প্রকার এবং ফাইল এক্সটেনশন লিখুন। সেকেন্ডারি MIME-এর প্রকার এবং ফাইল এক্সটেনশন এমন ফাইলকে দেখায় যা আপনার অ্যাপ খুলতে পারে, তবে আপনার অ্যাপের জন্য নির্দিষ্ট নয়। যেমন, আপনার অ্যাপটি একটি ছবি-এডিটিং অ্যাপ হতে পারে যা PNG এবং JPG ছবি খোলে। শুধুমাত্র স্ট্যান্ডার্ড মিডিয়া টাইপ অন্তর্ভুক্ত করুন এবং নিশ্চিত করুন যে সেগুলিতে কোনও টাইপো এবং বানান ভুল নেই। আপনার অ্যাপ যদি শুধু শর্টকাট বা থার্ড-পার্টি শর্টকাট ফাইল খোলে, তাহলে MIME-এর প্রকার ফাঁকা রাখতে পারেন।

    মনে রাখবেন: কোনও ব্যবহারকারী যদি একাধিক Drive অ্যাপ ইনস্টল করেন যা কোনও ফাইল খুলতে পারে, তাহলে ব্যবহারকারী অন্য কোনও অ্যাপ বেছে না নেওয়া পর্যন্ত সবচেয়ে সম্প্রতি ইনস্টল করা অ্যাপটি ব্যবহার করা হয়।

11. Drive UI-এর "নতুন" বোতাম ব্যবহার করতে এবং ব্যবহারকারীদের আপনার অ্যাপের মাধ্যমে ফাইল তৈরি করার অনুমতি দিতে, ফাইল তৈরি করা বক্সে টিকচিহ্ন দিন। নতুন URL এবং ঐচ্ছিক ডকুমেন্টের নাম ফিল্ড দেখা যাবে।

    • এই URL-এ অবশ্যই সম্পূর্ণভাবে উপযুক্ত ডোমেনের নাম (FQDN) থাকতে হবে; localhost কাজ করে না।
    • Google Workspace Marketplace-এ আপনার অ্যাপ তালিকাভুক্ত করার আগে আপনাকে অবশ্যই এই URL-এর মালিকানা যাচাই করতে হবে।
    • ডিফল্ট হিসেবে, Drive UI থেকে আপনার অ্যাপে ডেটা পাস করার জন্য এই URL-এ একটি state কোয়েরি প্যারামিটার যোগ করা হয়। state প্যারামিটারের কন্টেন্ট সম্পর্কে তথ্যের জন্য, state প্যারামিটার দেখুন।

12. নতুন URL ফিল্ডে URL লিখুন। ব্যবহারকারীকে আপনার অ্যাপ্লিকেশনে রিডাইরেক্ট করতে "নতুন" বোতাম এই URL ব্যবহার করে।

    মনে রাখবেন: ডকুমেন্টের নাম লেখার ফিল্ড ফাঁকা রাখুন। এই ফিল্ডটি আর ব্যবহার করা হয় না।

13. (ঐচ্ছিক) আপনার অ্যাপ যাতে Google Workspace-এ কাজ করে এমন ফাইল খুলতে পারে, তার জন্য ইমপোর্ট করা হচ্ছে বক্সে টিকচিহ্ন দিন।

14. (ঐচ্ছিক) আপনার অ্যাপকে শেয়ার্ড ড্রাইভে ফাইল ম্যানেজ করতে হলে, শেয়ার্ড ড্রাইভ সাপোর্ট বক্সে টিকচিহ্ন দিন। আপনার অ্যাপে শেয়ার্ড ড্রাইভ কীভাবে কাজ করবে সেই সম্পর্কে আরও জানতে, শেয়ার্ড ড্রাইভ সাপোর্ট প্রয়োগ করুন দেখুন।

15. জমা দিন বিকল্পে ক্লিক করুন।

drive.install স্কোপের জন্য অনুরোধ করুন

"এর মাধ্যমে খুলুন" বা "নতুন" মেনুতে কোনও অ্যাপকে বিকল্প হিসেবে দেখানোর অনুমতি দিতে, Drive UI-এর সাথে ইন্টিগ্রেট করার জন্য https://www.googleapis.com/auth/drive.install স্কোপের অনুরোধ করুন। এই স্কোপের জন্য অনুরোধ করার সময়, ব্যবহারকারীরা এই ধরনের ডায়ালগ দেখতে পান:

ছবি ১. Drive UI-এর জন্য স্কোপ ব্যবহার করার সময় ইনস্টলেশন ডায়ালগ।

Drive অ্যাপের জন্য আপনি যেসব স্কোপের অনুরোধ করতে পারেন এবং কীভাবে অনুরোধ করবেন সেই সম্পর্কে আরও জানতে, API-নির্দিষ্ট অনুমোদন ও যাচাইকরণ সংক্রান্ত তথ্য দেখুন।

মনে রাখবেন: আপনি যদি Google Workspace Marketplace-এ আপনার Drive অ্যাপ প্রকাশ করেন, তাহলে ব্যবহারকারী এবং ডোমেন অ্যাডমিনিস্ট্রেটররা Google Workspace Marketplace থেকে সরাসরি অ্যাপটি সার্চ করে ইনস্টল করতে পারবেন।

state প্যারামিটার

ডিফল্ট হিসেবে, Drive UI থেকে আপনার অ্যাপে ডেটা পাস করার জন্য Open URL এবং New URL, উভয়ের সাথেই একটি state প্যারামিটার যোগ করা হয়। এই প্যারামিটারে টেমপ্লেট ভেরিয়েবল সহ JSON-এনকোড করা স্ট্রিং এবং আপনার অ্যাপে করা অনুরোধ সম্পর্কিত ডেটা থাকে। অন্তর্ভুক্ত ভেরিয়েবলগুলি ব্যবহৃত URL-এর ধরনের (Open URL বা New URL) উপর নির্ভর করে:

টেমপ্লেট ভেরিয়েবেল	বিবরণ	URL অ্যাপ্লিকেশন
{ids}	খোলা হচ্ছে এমন ফাইল আইডির তালিকা, যা কমা দিয়ে আলাদা করা হয়েছে।	URL খুলুন
{exportIds}	এক্সপোর্ট করা হচ্ছে এমন ফাইল আইডির কমা দিয়ে আলাদা করা তালিকা। শুধুমাত্র Google Workspace ফাইল খোলার সময় ব্যবহার করা হয়।	URL খুলুন
{resourceKeys}	ফাইল আইডির JSON ডিকশনারি যা সংশ্লিষ্ট রিসোর্স কী-এর সাথে ম্যাপ করা আছে।	URL খুলুন
{folderId}	পেরেন্ট ফোল্ডারের আইডি।	নতুন ইউআরএল
{folderResourceKey}	পেরেন্ট ফোল্ডারের রিসোর্স কী।	নতুন ইউআরএল
{userId}	প্রোফাইল আইডি যা ব্যবহারকারীকে শনাক্ত করে।	URL ও নতুন URL খুলুন
{action}	অ্যাকশনটি পারফর্ম করা হচ্ছে। ভ্যালু হল open যখন URL খোলা হয় অথবা create যখন নতুন URL ব্যবহার করা হয়।	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 পদ্ধতিতে যেভাবে বর্ণনা করা হয়েছে সেইভাবে ফাইলের কন্টেন্ট ডাউনলোড করতে পারবে।

মনে রাখবেন: শর্টকাট ও থার্ড-পার্টি শর্টকাট থেকে ফাইল খোলা অ্যাপ সহ সব অ্যাপকে, কোনও ডকুমেন্টের জন্য ব্যবহারকারীর অনুমতি চেক করতে files.get মেথড কল করতে হবে। ব্যবহারকারী কোনও ফাইল এডিট বা সেভ করতে না পারলে, অ্যাপের উচিত কেবল-পঠনযোগ্য ব্যবহারকারীকে সেই ফাইল খোলার সময় সতর্ক করা (ব্যবহারকারীকে এডিট করার জন্য সময় ব্যয় করতে দিয়ে, তারপর সেভ করার সময় কোনও সমস্যা দেখানোর পরিবর্তে)।

সম্পর্কিত বিষয়

ইনস্টল করা অ্যাপকে Drive UI থেকে লঞ্চ করা অ্যাকশন তৈরি, ম্যানেজ ও খুলতে পারতে হবে। আরও জানতে, Drive UI-এর "নতুন" বোতামের সাথে ইন্টিগ্রেট করুন অথবা Drive UI-এর "এর মাধ্যমে খুলুন" প্রসঙ্গ মেনুর সাথে ইন্টিগ্রেট করুন দেখুন।