پوشه ها فایل هایی هستند که فقط حاوی ابرداده هستند و می توان از آنها برای سازماندهی فایل ها در Google Drive استفاده کرد. آنها دارای خواص زیر هستند:
- پوشه فایلی با نوع MIME
application/vnd.google-apps.folder
است و پسوندی ندارد. -
root
مستعار را می توان برای ارجاع به پوشه ریشه در هر جایی که شناسه فایل ارائه شده است استفاده کرد.
برای اطلاعات بیشتر درباره محدودیتهای پوشه Drive، محدودیتهای فایل و پوشه را ببینید.
این راهنما نحوه انجام برخی از وظایف اساسی مربوط به پوشه را توضیح می دهد.
یک پوشه ایجاد کنید
برای ایجاد یک پوشه، از روش files.create
با نوع application/vnd.google-apps.folder
MIME و عنوان استفاده کنید. نمونه کد زیر نحوه ایجاد یک پوشه با استفاده از کتابخانه مشتری را نشان می دهد:
جاوا
پایتون
Node.js
PHP
دات نت
یک فایل در یک پوشه خاص ایجاد کنید
برای ایجاد یک فایل در یک پوشه خاص، از روش files.create
استفاده کنید و شناسه پوشه را در ویژگی parents
فایل مشخص کنید.
ویژگی parents
شناسه پوشه والد حاوی فایل را نگه می دارد. ویژگی parents
را می توان هنگام ایجاد فایل ها در یک پوشه سطح بالا یا هر پوشه دیگری استفاده کرد.
یک فایل فقط می تواند یک پوشه والد داشته باشد. تعیین چند والدین پشتیبانی نمی شود.
نمونه کد زیر نحوه ایجاد یک فایل در یک پوشه خاص با استفاده از کتابخانه مشتری را نشان می دهد:
جاوا
پایتون
Node.js
PHP
دات نت
انتقال فایل ها بین پوشه ها
برای انتقال فایل ها، باید شناسه اموال parents
را به روز کنید.
برای افزودن یا حذف والدین برای یک فایل موجود، از روش files.update
با پارامترهای پرس و جو addParents
و removeParents
استفاده کنید.
یک فایل فقط می تواند یک پوشه والد داشته باشد. تعیین چند والدین پشتیبانی نمی شود.
نمونه کد زیر نحوه جابجایی فایل بین پوشه ها را با استفاده از کتابخانه مشتری نشان می دهد:
جاوا
پایتون
Node.js
PHP
دات نت
محدودیت های فایل و پوشه
فایلها و پوشههای Drive دارای محدودیتهایی برای ذخیرهسازی هستند.
محدودیت آیتم کاربر
هر کاربر می تواند تا 500 میلیون آیتم داشته باشد که توسط آن حساب ایجاد شده است. وقتی به حد مجاز رسید، کاربر دیگر نمیتواند مواردی را در Drive ایجاد یا آپلود کند. آنها همچنان می توانند موارد موجود را مشاهده و ویرایش کنند. برای ایجاد مجدد فایل، کاربران باید به طور دائم موارد را حذف کنند یا از حساب دیگری استفاده کنند. برای اطلاعات بیشتر، به حذفشدهها یا حذف فایلها و پوشهها مراجعه کنید.
اشیایی که در این حد حساب می شوند عبارتند از:
- موارد ایجاد یا آپلود شده توسط کاربر در Drive
- مواردی که توسط کاربر ایجاد شده است اما اکنون متعلق به شخص دیگری است
- اقلام موجود در سطل زباله
- میانبرها
- میانبرهای شخص ثالث
اشیایی که در این حد به حساب نمی آیند عبارتند از:
- موارد حذف شده برای همیشه
- موارد به اشتراک گذاشته شده با کاربر اما متعلق به شخص دیگری است
- مواردی که متعلق به کاربر است اما توسط شخص دیگری ایجاد شده است
تلاش برای افزودن بیش از 500 میلیون مورد، پاسخ کد وضعیت HTTP activeItemCreationLimitExceeded
را نشان می دهد.
توجه داشته باشید که اگرچه محدودیتی برای تعداد مواردی که یک حساب سرویس میتواند داشته باشد وجود ندارد، محدودیت 500 میلیون موردی برای تعداد مواردی که یک حساب خدمات میتواند ایجاد کند اعمال میشود.
محدودیت مورد پوشه
هر پوشه در My Drive یک کاربر دارای محدودیت 500000 مورد است. این محدودیت برای پوشه اصلی My Drive اعمال نمی شود. مواردی که در این حد به حساب می آیند عبارتند از:
- پوشه ها
- فایل ها همه انواع فایل، صرف نظر از مالکیت فایل.
- میانبرها به عنوان یک مورد در یک پوشه به حساب می آید، حتی اگر موردی که به آن اشاره می کند در آن پوشه نباشد. برای اطلاعات بیشتر، به ایجاد میانبر برای فایل Drive مراجعه کنید.
- میانبرهای شخص ثالث به عنوان یک مورد در یک پوشه به حساب می آید، حتی اگر موردی که به آن اشاره می کند در آن پوشه نباشد. برای اطلاعات بیشتر، به ایجاد فایل میانبر برای محتوای ذخیره شده توسط برنامه خود مراجعه کنید.
برای اطلاعات بیشتر درباره محدودیتهای پوشه، به محدودیتهای پوشه در Google Drive مراجعه کنید.
محدودیت عمق پوشه
My Drive یک کاربر نمی تواند بیش از 100 سطح پوشه تودرتو داشته باشد. این بدان معنی است که یک پوشه فرزند را نمی توان در پوشه ای با عمق بیش از 99 سطح ذخیره کرد. این محدودیت فقط برای پوشه های فرزند اعمال می شود. یک فایل فرزند با نوع MIME غیر از application/vnd.google-apps.folder
از این محدودیت مستثنی است.
به عنوان مثال، در نمودار زیر یک پوشه جدید را می توان در داخل پوشه شماره 99 قرار داد اما نه در داخل پوشه شماره 100. با این حال، پوشه شماره 100 می تواند فایل ها را مانند هر پوشه درایو دیگری ذخیره کند:
تلاش برای افزودن بیش از 100 سطح پوشه، پاسخ کد وضعیت HTTP myDriveHierarchyDepthLimitExceeded
را برمیگرداند.