এই নির্দেশিকায় ড্রাইভ এপিআই (Drive API) ব্যবহার করে ক্লায়েন্ট-সাইড এনক্রিপ্টেড (CSE) ফাইলগুলো একসাথে অনেকগুলো ফাইল ইম্পোর্ট করার জন্য একটি কাস্টম টুল তৈরির সেরা পদ্ধতিগুলো আলোচনা করা হয়েছে।
সেলফ-সার্ভিস মাইগ্রেশনের জন্য ডেস্কটপের জন্য ড্রাইভ বিবেচনা করুন।
একজন ব্যবহারকারী Drive for desktop ক্লায়েন্ট ব্যবহার করে তার স্থানীয় মেশিন থেকে ফাইল ইম্পোর্ট করতে পারেন। এটি ক্লায়েন্ট-সাইড এনক্রিপশনকে সম্পূর্ণরূপে সমর্থন করে এবং ব্যবহারকারীদের নিজেদের ফাইল এনক্রিপ্ট ও আপলোড করার সুযোগ দেয়। এই নির্দেশিকায় বর্ণিত কাস্টম টুল তৈরি করা শুধুমাত্র বৃহৎ পরিসরে, স্বয়ংক্রিয়, বা একাধিক ব্যবহারকারীর দ্বারা একসাথে অনেক ফাইল ইম্পোর্ট করার জন্য প্রয়োজন।
শুরু করার আগে
আপনাকে অবশ্যই বুঝতে হবে কিভাবে একটি একক ক্লায়েন্ট-সাইড এনক্রিপ্টেড ফাইল পরিচালনা করতে হয়। এনক্রিপশন, আপলোড/ডাউনলোড এবং ডিক্রিপশনের মৌলিক ধাপগুলো জানতে 'Manage individual CSE files' পর্যালোচনা করুন, যার মধ্যে টোকেন তৈরি এবং আপনার Key Access Control List Service (KACLS)-এর সাথে ইন্টারঅ্যাক্ট করার পদ্ধতিও অন্তর্ভুক্ত রয়েছে।
একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করে প্রমাণীকরণ করুন
ড্রাইভ এপিআই (Drive API) ব্যবহারের সময় ডোমেন-ব্যাপী ডেলিগেশন সহ একটি সার্ভিস অ্যাকাউন্ট ব্যবহার করুন। এটি আপনার অ্যাপ্লিকেশনকে ব্যবহারকারীদের ছদ্মবেশ ধারণ করার সুযোগ দেয়, যার ফলে আপনি প্রোগ্রাম্যাটিকভাবে তাদের মধ্যে লুপ চালিয়ে সরাসরি তাদের পক্ষ থেকে ফাইল আপলোড করতে পারেন।
ডিরেক্টরি কাঠামোটি পুনরায় তৈরি করুন
আপনার ইম্পোর্ট টুলটিকে এমনভাবে ডিজাইন করুন যাতে এটি সোর্স ফাইল ও ফোল্ডারগুলোতে রিকার্সিভলি ট্র্যাভার্স করে ড্রাইভে বিদ্যমান ডিরেক্টরি স্ট্রাকচারটির প্রতিচ্ছবি তৈরি করতে পারে। এর মূল প্রক্রিয়াটি নিম্নরূপ:
- প্রতিটি সোর্স ডিরেক্টরির জন্য একটি সংশ্লিষ্ট ড্রাইভ ফোল্ডার তৈরি করুন।
- ডিরেক্টরির ফাইলগুলো এনক্রিপ্ট করে তৈরি করা ড্রাইভ ফোল্ডারে আপলোড করুন ।
- সাবডিরেক্টরিগুলোর জন্যও প্রক্রিয়াটি পুনরাবৃত্তি করুন।
সঠিক জায়গায় ফাইলগুলো আপলোড করুন
সর্বদা সঠিক ব্যবহারকারীর 'মাই ড্রাইভ' বা অ্যাক্সেসযোগ্য কোনো শেয়ার্ড ড্রাইভে ফাইল আপলোড করুন। কোনো শেয়ার্ড ড্রাইভ বা ফোল্ডার আইডি খুঁজে পেতে, ড্রাইভ ওয়েব ইউআরএল থেকে স্থিরভাবে অথবা drives.list এবং files.list মেথড ব্যবহার করে গতিশীলভাবে এটি খুঁজুন।
নকল প্রতিরোধ করা
ড্রাইভ একই ফোল্ডারে একাধিক ফাইলকে হুবহু একই ফাইলের নাম ব্যবহার করার অনুমতি দেয়। ফাইল আপলোড করার আগে সেগুলোর জন্য আইডি তৈরি করে নিন। এই কাজটি করার জন্য আপনি ড্রাইভ এপিআই-এর files.generateIds মেথডটি ব্যবহার করতে পারেন।
এই পূর্ব-তৈরি আইডিগুলো সংরক্ষণ করার মাধ্যমে, আপনার ইম্পোর্টার প্রতিটি ফাইলকে তার নির্দিষ্ট আইডিতে আপলোড করার চেষ্টা করতে পারে। যদি সেই আইডিতে কোনো ফাইল আগে থেকেই বিদ্যমান থাকে, তবে আপনার টুলটি নিরাপদে সেটিকে এড়িয়ে যেতে পারে। পূর্ব-তৈরি আইডি ব্যবহার করলে আপনার টুলটি কোনো ক্র্যাশ থেকে পুনরুদ্ধার করতে সাহায্য করবে।
প্রতিটি আপলোডের আগে একটি সিএসই টোকেনের জন্য অনুরোধ করুন।
কী র্যাপিং এবং ফাইল আপলোডের ঠিক আগে প্রতিটি ফাইলের জন্য generateCseToken কল করুন। এই পদ্ধতিটি নিশ্চিত করে যে টোকেনটি সংশ্লিষ্ট মেটাডেটার বর্তমান অবস্থাকে সঠিকভাবে প্রতিফলিত করে, যা পরিবর্তিত হতে পারে।
বড় ফাইলের জন্য রিস্যুমেবল আপলোড ব্যবহার করুন।
বড় ফাইল স্থানান্তরের জন্য ড্রাইভ এপিআই-এর রিজিউমেবল আপলোড ব্যবহার করুন। রিজিউমেবল আপলোড আপনার ইম্পোর্টারকে নেটওয়ার্ক বিঘ্নের সময় সম্পূর্ণ ফাইল আপলোড পুনরায় শুরু করার পরিবর্তে ব্যর্থ হওয়া অংশগুলো আবার চেষ্টা করার সুযোগ দেয়।
শেয়ারিং অনুমতি পুনরুদ্ধার করুন
আপনার বাল্ক ইম্পোর্ট টুলের যদি শেয়ারিং পারমিশন সংরক্ষণ করার প্রয়োজন হয়, তাহলে প্রথমে ফাইলটি এনক্রিপ্ট করে আপলোড করুন এবং তারপর permissions.create মেথডটি কল করুন। ফাইল আপলোডের সময় শেয়ারিং পারমিশন প্রয়োগ করা হয় না।
টোকেনের মেয়াদ শেষ হওয়া পরিচালনা করুন
দীর্ঘক্ষণ ধরে চলা অপারেশনের ক্ষেত্রে, টোকেনের মেয়াদ শেষ হয়ে যাওয়ার কারণে আপনার স্ক্রিপ্টে অথেনটিকেশন ত্রুটি দেখা দিতে পারে। অ্যাক্সেস টোকেন স্বয়ংক্রিয়ভাবে রিফ্রেশ করতে এবং আপলোড পুনরায় চেষ্টা করার জন্য লজিক প্রয়োগ করুন। আরও বিস্তারিত জানতে, ওপেন সোর্স উদাহরণটি দেখুন, যেখানে একটিমাত্র ফাইল এনক্রিপ্ট এবং আপলোড করার পদ্ধতি দেখানো হয়েছে।
আমদানি করা ফাইলগুলি পুঙ্খানুপুঙ্খভাবে যাচাই করুন।
একসাথে অনেক ফাইল ইম্পোর্ট করার পর পুঙ্খানুপুঙ্খভাবে যাচাই করুন। গুগল সার্ভার-সাইডে আপনার ফাইল ডিক্রিপ্ট এবং যাচাই করতে পারে না। ‘ ইম্পোর্ট করা ফাইল যাচাই করুন’ বিভাগে আলাদা আলাদা ফাইল যাচাই করার বিভিন্ন পদ্ধতির বিস্তারিত বিবরণ দেওয়া আছে।
বৃহৎ পরিসরে যাচাই করার একটি অতিরিক্ত পদ্ধতি, যা বিশেষ করে একসাথে অনেক ফাইল ইম্পোর্ট করার পরে কার্যকর, তা হলো অফিসিয়াল ডিক্রিপ্টার টুল ব্যবহার করা। প্রথমে, গুগল টেকআউট ব্যবহার করে ড্রাইভ থেকে এনক্রিপ্টেড কন্টেন্ট ডাউনলোড করুন। তারপর, ডিক্রিপ্টার টুল ব্যবহার করে ডিক্রিপশনের চেষ্টা করুন। এই প্রক্রিয়াটি এমন ফাইলগুলো শনাক্ত করতে সাহায্য করে যা ডিক্রিপ্ট করা যায় না, যা আপনার ইম্পোর্ট টুলের এনক্রিপশন বা কী র্যাপিং লজিকে সম্ভাব্য সমস্যা নির্দেশ করে।
সীমা ও কোটা বুঝুন
ক্লায়েন্ট-সাইডে এনক্রিপ্ট করা ফাইলগুলো ড্রাইভের সাধারণ সীমা এবং কোটার অধীন। শেয়ার্ড ড্রাইভের সীমা , সাধারণ ফাইল ও ফোল্ডারের সীমা এবং আপনার কোটা কীভাবে পরিচালনা করবেন সে সম্পর্কে সচেতন থাকুন। এছাড়াও, আপনার ইম্পোর্ট টুলটিকে অবশ্যই আপনার কী অ্যাক্সেস কন্ট্রোল লিস্ট সার্ভিস (KACLS) এবং আপনার আইডেন্টিটি প্রোভাইডার (IdP) থেকে আসা রেট লিমিটগুলো সামলাতে হবে।