অ্যাপ্লিকেশন ডেটা ফোল্ডার হলো একটি বিশেষ লুকানো ফোল্ডার যা আপনার অ্যাপ অ্যাপ্লিকেশন-নির্দিষ্ট ডেটা, যেমন কনফিগারেশন ফাইল, সংরক্ষণ করতে ব্যবহার করতে পারে। আপনি যখন এর মধ্যে কোনো ফাইল তৈরি করার চেষ্টা করেন, তখন অ্যাপ্লিকেশন ডেটা ফোল্ডারটি স্বয়ংক্রিয়ভাবে তৈরি হয়ে যায়। এমন যেকোনো ফাইল সংরক্ষণ করতে এই ফোল্ডারটি ব্যবহার করুন, যেগুলোর সাথে ব্যবহারকারীর সরাসরি সংযোগ থাকা উচিত নয়। এই ফোল্ডারটি শুধুমাত্র আপনার অ্যাপের জন্য অ্যাক্সেসযোগ্য এবং এর ভেতরের বিষয়বস্তু ব্যবহারকারী ও অন্যান্য গুগল ড্রাইভ অ্যাপ থেকে লুকানো থাকে।
যখন কোনো ব্যবহারকারী তাদের 'মাই ড্রাইভ' থেকে আপনার অ্যাপটি আনইনস্টল করেন, তখন অ্যাপ্লিকেশন ডেটা ফোল্ডারটি মুছে ফেলা হয়। ব্যবহারকারীরা ম্যানুয়ালিও আপনার অ্যাপের ডেটা ফোল্ডারটি মুছে ফেলতে পারেন।
অ্যাপ্লিকেশন ডেটা ফোল্ডারের পরিধি
অ্যাপ্লিকেশন ডেটা ফোল্ডার অ্যাক্সেস করার আগে, আপনাকে অবশ্যই https://www.googleapis.com/auth/drive.appdata নন-সেনসিটিভ স্কোপটির জন্য অ্যাক্সেসের অনুরোধ করতে হবে। স্কোপ এবং সেগুলিতে কীভাবে অ্যাক্সেসের অনুরোধ করতে হয় সে সম্পর্কে আরও তথ্যের জন্য, "গুগল ড্রাইভ এপিআই স্কোপ নির্বাচন করুন" দেখুন। নির্দিষ্ট OAuth 2.0 স্কোপ সম্পর্কে আরও তথ্যের জন্য, "গুগল এপিআই-এর জন্য OAuth 2.0 স্কোপ" দেখুন।
অ্যাপ্লিকেশন ডেটা ফোল্ডার এবং ড্রাইভ ব্যাকআপ ফোল্ডারের মধ্যে পার্থক্য
অ্যাপ্লিকেশন ডেটা ফোল্ডারটি আপনার ড্রাইভ ব্যাকআপ ফোল্ডার থেকে আলাদা।
অ্যাপ্লিকেশন ডেটা ফোল্ডার হলো একটি কনফিগারেশন ফোল্ডার যা প্রতিটি থার্ড-পার্টি অ্যাপের জন্য তৈরি করা হয় এবং প্রতিটি থার্ড-পার্টি অ্যাপ এতে ডেটা সংরক্ষণ করতে পারে। শুধুমাত্র যে অ্যাপ্লিকেশনটি appDataFolder এ ডেটা তৈরি করেছে, সেটিই এটি অ্যাক্সেস করতে পারে। ড্রাইভ ইউজার ইন্টারফেস (UI) ব্যবহার করে এই ফোল্ডারটি অ্যাক্সেস করা যায় না।
আপনার ড্রাইভ ব্যাকআপ ফোল্ডারটি একটি সংরক্ষিত ফোল্ডার যেখানে ড্রাইভ ডিভাইস ব্যাকআপগুলো সংরক্ষণ করে এবং এটি ড্রাইভ UI-তে দেখা যায়।
অ্যাপ্লিকেশন ডেটা ফোল্ডারের উপর সীমাবদ্ধতা
অ্যাপ্লিকেশন ডেটা ফোল্ডার নিয়ে কাজ করার সময় নিম্নলিখিত সীমাবদ্ধতাগুলো প্রযোজ্য হয়:
আপনি অ্যাপ্লিকেশন ডেটা ফোল্ডারের ভিতরে ফাইল বা ফোল্ডার শেয়ার করতে পারবেন না। এটি করার চেষ্টা করলে
notSupportedForAppDataFolderFiles" ত্রুটি দেখা দেয় এবং নিম্নলিখিত ত্রুটি বার্তাটি প্রদর্শিত হয়: "অ্যাপ্লিকেশন ডেটা ফোল্ডারের ভিতরের ফাইলগুলির জন্য এই পদ্ধতিটি সমর্থিত নয়।"আপনি
appDataFolderভেতরের ফাইলগুলোকে এক স্টোরেজ লোকেশন (স্পেস) থেকে অন্য স্টোরেজ লোকেশনে সরাতে পারবেন না। এমন করার চেষ্টা করলেnotSupportedForAppDataFolderFilesএরর তৈরি হয় এবং সাথে নিম্নলিখিত এরর মেসেজটি দেখায়: "অ্যাপ্লিকেশন ডেটা ফোল্ডারের ভেতরের ফাইলগুলোর জন্য এই পদ্ধতিটি সমর্থিত নয়।" আরও তথ্যের জন্য, ফাইল অর্গানাইজেশন দেখুন।অ্যাপ্লিকেশন ডেটা ফোল্ডারের ভেতরের ফাইল বা ফোল্ডার ট্র্যাশ করা যায় না। তা করার চেষ্টা করলে
notSupportedForAppDataFolderFilesত্রুটি দেখা দেয় এবং নিম্নলিখিত ত্রুটি বার্তাটি প্রদর্শিত হয়: "অ্যাপ্লিকেশন ডেটা ফোল্ডারের ভেতরের ফাইলগুলো ট্র্যাশ করা যাবে না।"
অ্যাপ্লিকেশন ডেটা ফোল্ডারে একটি ফাইল তৈরি করুন
অ্যাপ্লিকেশন ডেটা ফোল্ডারে একটি ফাইল তৈরি করতে, ফাইলটির parents প্রপার্টিতে appDataFolder উল্লেখ করুন এবং ফোল্ডারটিতে ফাইলটি তৈরি করার জন্য files.create মেথডটি ব্যবহার করুন।
নিম্নলিখিত কোড নমুনাটিতে দেখানো হয়েছে কিভাবে একটি ক্লায়েন্ট লাইব্রেরি এবং কার্ল (curl) কমান্ড ব্যবহার করে একটি ফোল্ডারে ফাইল যুক্ত করতে হয়।
জাভা
পাইথন
নোড.জেএস
পিএইচপি
.NET
কার্ল
অনুরোধ :
curl --request POST \
'https://content.googleapis.com/drive/v3/files' \
-H 'authorization: Bearer ACCESS_TOKEN' \
-H 'content-type: application/json' \
-H 'x-origin: https://explorer.apis.google.com' \
--data-raw '{"name": "config.json", "parents":["appDataFolder"]}'
ACCESS_TOKEN জায়গায় আপনার অ্যাপের OAuth 2.0 টোকেনটি বসান।
প্রতিক্রিয়া :
{
"kind": "drive#file",
"id": FILE_ID,
"name": "config.json",
"mimeType": "application/json"
}
ফোল্ডারে ফাইল তৈরি করার বিষয়ে আরও তথ্যের জন্য, “ফোল্ডার তৈরি ও তাতে ডেটা যুক্ত করুন” অংশটি দেখুন।
অ্যাপ্লিকেশন ডেটা ফোল্ডারে ফাইলগুলি অনুসন্ধান করুন
অ্যাপ্লিকেশন ডেটা ফোল্ডারে ফাইল অনুসন্ধান করতে, spaces ফিল্ডটিকে appDataFolder এ সেট করুন এবং files.list মেথডটি ব্যবহার করুন।
নিম্নলিখিত কোড নমুনাটিতে একটি ক্লায়েন্ট লাইব্রেরি এবং একটি কার্ল (curl) কমান্ড ব্যবহার করে অ্যাপ্লিকেশন ডেটা ফোল্ডারে ফাইল অনুসন্ধান করার পদ্ধতি দেখানো হয়েছে।
জাভা
পাইথন
নোড.জেএস
পিএইচপি
.NET
কার্ল
অনুরোধ :
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN" \
"https://www.googleapis.com/drive/v3/files?spaces=appDataFolder&fields=files(id,name,mimeType,size,modifiedTime)"
ACCESS_TOKEN জায়গায় আপনার অ্যাপের OAuth 2.0 টোকেনটি বসান।
প্রতিক্রিয়া :
{
"files": [
{
"mimeType": "application/json",
"size": "256",
"id": FILE_ID,
"name": "config.json",
"modifiedTime": "2025-04-03T23:40:05.860Z"
},
{
"mimeType": "text/plain",
"size": "128",
"id": FILE_ID,
"name": "user_settings.txt",
"modifiedTime": "2025-04-02T17:52:29.020Z"
}
]
}
অ্যাপ্লিকেশন ডেটা ফোল্ডার থেকে ফাইলগুলি ডাউনলোড করুন
অ্যাপ্লিকেশন ডেটা ফোল্ডার থেকে কোনো ফাইল ডাউনলোড করতে, রেসপন্স বডিতে ফাইলের বিষয়বস্তু পাওয়ার জন্য alt=media URL প্যারামিটারসহ files.get মেথডটি ব্যবহার করুন। আরও তথ্যের জন্য এবং কোডের নমুনা দেখতে, "Download blob file content" অংশে যান।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি কার্ল (curl) কমান্ড ব্যবহার করে অ্যাপ্লিকেশন ডেটা ফোল্ডার থেকে ফাইল ডাউনলোড করতে হয়। কী সংরক্ষণ করা হচ্ছে তার উপর নির্ভর করে রেসপন্স বডি ভিন্ন হবে।
কার্ল
অনুরোধ :
curl \
-X GET \
-H "Authorization: Bearer ACCESS_TOKEN" \
"https://www.googleapis.com/drive/v3/files/FILE_ID?alt=media"
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
- ACCESS_TOKEN : আপনার অ্যাপের OAuth 2.0 টোকেন।
- FILE_ID : যে ফাইলটি আপনি ডাউনলোড করতে চান তার আইডি।