پوشه داده های برنامه یک پوشه مخفی ویژه است که برنامه شما می تواند از آن برای ذخیره داده های خاص برنامه مانند فایل های پیکربندی استفاده کند. پوشه داده برنامه به طور خودکار هنگامی که می خواهید یک فایل در آن ایجاد کنید ایجاد می شود. از این پوشه برای ذخیره فایلهایی که کاربر نباید مستقیماً با آنها تعامل داشته باشد، استفاده کنید. این پوشه فقط توسط برنامه شما قابل دسترسی است و محتوای آن از دید کاربر و سایر برنامه های Google Drive پنهان است.
پوشه داده های برنامه زمانی که کاربر برنامه شما را از My Drive خود حذف نصب می کند، حذف می شود. کاربران همچنین می توانند پوشه داده برنامه شما را به صورت دستی حذف کنند.
قبل از اینکه بتوانید به پوشه داده های برنامه دسترسی داشته باشید، باید دسترسی به https://www.googleapis.com/auth/drive.appdata محدوده غیر حساس را درخواست کنید. برای اطلاعات بیشتر در مورد دامنهها و نحوه درخواست دسترسی به آنها، به انتخاب حوزههای API Google Drive مراجعه کنید. برای اطلاعات بیشتر درباره حوزههای خاص OAuth 2.0، به OAuth 2.0 Scopes برای Google API مراجعه کنید.
پوشه داده برنامه جدا از پوشه پشتیبان Drive شما است.
پوشه داده های برنامه یک پوشه پیکربندی است که برای هر برنامه شخص ثالث ایجاد می شود و هر برنامه شخص ثالث می تواند داده ها را در آن ذخیره کند. فقط برنامهای که دادهها را در appDataFolder ایجاد کرده است میتواند به آن دسترسی داشته باشد. با استفاده از رابط کاربری Drive (UI) نمی توان به پوشه دسترسی پیدا کرد.
پوشه پشتیبان Drive شما یک پوشه رزرو شده است که Drive نسخههای پشتیبان دستگاه را در آن مینویسد و در رابط کاربری Drive قابل مشاهده است.
هنگام کار با پوشه داده برنامه، محدودیت های زیر اعمال می شود:
شما نمی توانید فایل ها یا پوشه ها را در داخل پوشه داده های برنامه به اشتراک بگذارید. تلاش برای انجام این کار یک خطای
notSupportedForAppDataFolderFilesبا پیام خطای زیر ایجاد می کند: "روش برای فایل های داخل پوشه Application Data پشتیبانی نمی شود."شما نمی توانید فایل های موجود در
appDataFolderرا بین مکان های ذخیره سازی (فضاها) جابه جا کنید. تلاش برای انجام این کار یک خطایnotSupportedForAppDataFolderFilesبا پیام خطای زیر ایجاد می کند: "روش برای فایل های داخل پوشه Application Data پشتیبانی نمی شود." برای اطلاعات بیشتر، سازماندهی فایل را ببینید.نمیتوانید فایلها یا پوشهها را در پوشه دادههای برنامه حذف کنید. تلاش برای انجام این کار یک خطای
notSupportedForAppDataFolderFilesبا پیام خطای زیر ایجاد می کند: "فایل های داخل پوشه Application Data نمی توانند سطل زباله شوند."
برای ایجاد یک فایل در پوشه داده برنامه، appDataFolder در ویژگی parents فایل مشخص کنید و از روش files.create برای ایجاد فایل در پوشه استفاده کنید.
نمونه کد زیر نشان می دهد که چگونه می توان یک فایل را با استفاده از کتابخانه مشتری و دستور curl در یک پوشه وارد کرد.
درخواست :
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 نشان میدهد.
درخواست :
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"
}
]
}
برای دانلود یک فایل از پوشه داده برنامه، از روش files.get با پارامتر alt=media URL استفاده کنید تا محتویات فایل در بدنه پاسخ بازیابی شود. برای اطلاعات بیشتر و مشاهده نمونه کد، به دانلود محتوای فایل blob بروید.
نمونه کد زیر نحوه دانلود فایل ها در پوشه داده برنامه را با استفاده از دستور 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 : شناسه فایلی که می خواهید دانلود کنید.
پوشه داده های برنامه یک پوشه مخفی ویژه است که برنامه شما می تواند از آن برای ذخیره داده های خاص برنامه مانند فایل های پیکربندی استفاده کند. پوشه داده برنامه به طور خودکار هنگامی که می خواهید یک فایل در آن ایجاد کنید ایجاد می شود. از این پوشه برای ذخیره فایلهایی که کاربر نباید مستقیماً با آنها تعامل داشته باشد، استفاده کنید. این پوشه فقط توسط برنامه شما قابل دسترسی است و محتوای آن از دید کاربر و سایر برنامه های Google Drive پنهان است.
پوشه داده های برنامه زمانی که کاربر برنامه شما را از My Drive خود حذف نصب می کند، حذف می شود. کاربران همچنین می توانند پوشه داده برنامه شما را به صورت دستی حذف کنند.
قبل از اینکه بتوانید به پوشه داده های برنامه دسترسی داشته باشید، باید دسترسی به https://www.googleapis.com/auth/drive.appdata محدوده غیر حساس را درخواست کنید. برای اطلاعات بیشتر در مورد دامنهها و نحوه درخواست دسترسی به آنها، به انتخاب حوزههای API Google Drive مراجعه کنید. برای اطلاعات بیشتر درباره حوزههای خاص OAuth 2.0، به OAuth 2.0 Scopes برای Google API مراجعه کنید.
پوشه داده برنامه جدا از پوشه پشتیبان Drive شما است.
پوشه داده های برنامه یک پوشه پیکربندی است که برای هر برنامه شخص ثالث ایجاد می شود و هر برنامه شخص ثالث می تواند داده ها را در آن ذخیره کند. فقط برنامهای که دادهها را در appDataFolder ایجاد کرده است میتواند به آن دسترسی داشته باشد. با استفاده از رابط کاربری Drive (UI) نمی توان به پوشه دسترسی پیدا کرد.
پوشه پشتیبان Drive شما یک پوشه رزرو شده است که Drive نسخههای پشتیبان دستگاه را در آن مینویسد و در رابط کاربری Drive قابل مشاهده است.
هنگام کار با پوشه داده برنامه، محدودیت های زیر اعمال می شود:
شما نمی توانید فایل ها یا پوشه ها را در داخل پوشه داده های برنامه به اشتراک بگذارید. تلاش برای انجام این کار یک خطای
notSupportedForAppDataFolderFilesبا پیام خطای زیر ایجاد می کند: "روش برای فایل های داخل پوشه Application Data پشتیبانی نمی شود."شما نمی توانید فایل های موجود در
appDataFolderرا بین مکان های ذخیره سازی (فضاها) جابه جا کنید. تلاش برای انجام این کار یک خطایnotSupportedForAppDataFolderFilesبا پیام خطای زیر ایجاد می کند: "روش برای فایل های داخل پوشه Application Data پشتیبانی نمی شود." برای اطلاعات بیشتر، سازماندهی فایل را ببینید.نمیتوانید فایلها یا پوشهها را در پوشه دادههای برنامه حذف کنید. تلاش برای انجام این کار یک خطای
notSupportedForAppDataFolderFilesبا پیام خطای زیر ایجاد می کند: "فایل های داخل پوشه Application Data نمی توانند سطل زباله شوند."
برای ایجاد یک فایل در پوشه داده برنامه، appDataFolder در ویژگی parents فایل مشخص کنید و از روش files.create برای ایجاد فایل در پوشه استفاده کنید.
نمونه کد زیر نشان می دهد که چگونه می توان یک فایل را با استفاده از کتابخانه مشتری و دستور curl در یک پوشه وارد کرد.
درخواست :
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 نشان میدهد.
درخواست :
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"
}
]
}
برای دانلود یک فایل از پوشه داده برنامه، از روش files.get با پارامتر alt=media URL استفاده کنید تا محتویات فایل در بدنه پاسخ بازیابی شود. برای اطلاعات بیشتر و مشاهده نمونه کد، به دانلود محتوای فایل blob بروید.
نمونه کد زیر نحوه دانلود فایل ها در پوشه داده برنامه را با استفاده از دستور 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 : شناسه فایلی که می خواهید دانلود کنید.