این راهنما شامل وظایف مربوط به مدیریت درایوهای مشترک، مانند ایجاد درایوهای مشترک و مدیریت اعضا و مجوزها، با استفاده از Google Drive API است.
برای اطلاعات بیشتر درباره محدودیتهای پوشه درایو مشترک، به محدودیتهای پوشه مراجعه کنید.
ایجاد درایوهای مشترک
برای ایجاد یک درایو مشترک، از روش drives.create
استفاده کنید.
جاوا
پایتون
Node.js
PHP
دات نت
تماسهای متد drives.create
بیتوان هستند.
پارامتر requestId
تلاش منطقی برای ایجاد درایو مشترک را مشخص می کند. اگر زمان درخواست به پایان برسد یا یک خطای نامشخص باطن را برگرداند، همان درخواست می تواند تکرار شود. requestId
و بدنه درخواست باید ثابت بماند.
اگر درایو مشترک بر اساس درخواست قبلی یا به دلیل تلاش مجدد با موفقیت ایجاد شده باشد، پاسخ عادی برگردانده می شود. گاهی اوقات، مانند پس از مدت زمان طولانی یا اگر بدنه درخواست تغییر کرده است، ممکن است یک خطای 409
برگردانده شود که نشان می دهد requestId
باید نادیده گرفته شود.
اعضای درایو مشترک را اضافه یا حذف کنید
اعضای درایو مشترک را با استفاده از منبع permissions
اضافه یا حذف کنید.
برای افزودن یک عضو، مجوز را در درایو مشترک ایجاد کنید. همچنین میتوان از روشهای مجوز بر روی فایلهای فردی در درایو مشترک استفاده کرد تا به اعضا امتیازات بیشتری اعطا کند یا به افراد غیرعضو اجازه دهد تا در موارد خاص با یکدیگر همکاری کنند.
برای اطلاعات بیشتر و نمونه کد، به اشتراک گذاری فایل ها، پوشه ها و درایوها مراجعه کنید.
درایو مشترک را حذف کنید
از روش drives.delete
برای حذف درایو مشترک استفاده کنید. قبل از حذف درایو مشترک، تمام محتوای درایو مشترک باید به حذفشدهها منتقل شود یا حذف شود.
درایوهای مشترک را برای مدیران دامنه مدیریت کنید
پارامتر useDomainAdminAccess
را با drives
و منابع permissions
برای مدیریت درایوهای مشترک در سراسر یک سازمان اعمال کنید.
کاربرانی که این روشها را با useDomainAdminAccess=true
فراخوانی میکنند باید از امتیاز سرپرست Drive and Docs
برخوردار باشند. سرپرستان میتوانند درایوهای مشترک را جستجو کنند یا مجوزهای بهروزرسانی برای درایوهای مشترک متعلق به سازمانشان را بدون توجه به عضویت سرپرست در هر درایو مشترک مشخصی جستجو کنند.
درایو مشترکی را که سازمان دهنده ندارد بازیابی کنید
مثال زیر نحوه استفاده از این منابع را برای بازیابی درایوهای مشترکی که دیگر سازمان دهنده ندارند نشان می دهد.
جاوا
پایتون
Node.js
PHP
دات نت
از دانلود، چاپ یا کپی کردن فایل توسط کاربران جلوگیری کنید
میتوانید نحوه دانلود، چاپ و کپی فایلها را در درایوهای مشترک محدود کنید.
برای تعیین اینکه آیا کاربر میتواند محدودیتهای دانلود اعمال شده توسط سازماندهنده درایو مشترک را تغییر دهد، فیلد بولی capabilities.canChangeDownloadRestriction
را بررسی کنید. اگر capabilities.canChangeDownloadRestriction
روی true
تنظیم شده باشد، محدودیت های دانلود را می توان در درایو مشترک اعمال کرد. برای اطلاعات بیشتر، به درک قابلیتهای فایل مراجعه کنید.
منبع drives
شامل مجموعهای از فیلدهای restrictions
بولی است که برای نشان دادن اینکه آیا میتوان یک عمل را روی درایو مشترک انجام داد یا خیر. محدودیتها برای درایو مشترک یا موارد داخل درایو مشترک اعمال میشود. محدودیت ها را می توان با استفاده از روش drives.update
تنظیم کرد.
برای اعمال محدودیتهای دانلود در درایو مشترک، یک مدیر درایو مشترک میتواند فیلد restrictions.downloadRestriction
منبع drives
را با استفاده از شی DownloadRestriction
تنظیم کند. با تنظیم فیلد بولی restrictedForReaders
روی true
اعلام می شود که هم دانلود و هم کپی برای خوانندگان محدود شده است. تنظیم فیلد بولی restrictedForWriters
روی true
اعلام می کند که هم دانلود و هم کپی برای نویسندگان محدود است. توجه داشته باشید که اگر قسمت restrictedForWriters
true
باشد، دانلود و کپی نیز برای خوانندگان محدود است. به طور مشابه، تنظیم restrictedForWriters
روی true
و restrictedForReaders
به false
معادل با تنظیم هم restrictedForWriters
و هم restrictedForReaders
روی true
است.
سازگاری به عقب
با معرفی شیء DownloadRestriction
، عملکرد فیلد بولی restrictions.copyRequiresWriterPermission
به روز شد.
اکنون، با تنظیم restrictions.copyRequiresWriterPermission
روی true
، فیلد بولین restrictedForReaders
شی DownloadRestriction
را به true
به روز می کند تا اعلام کند که هم دانلود و هم کپی برای خوانندگان محدود شده است.
تنظیم فیلد copyRequiresWriterPermission
روی false
، هر دو فیلد restrictedForWriters
و restrictedForReaders
را روی false
بهروزرسانی میکند. این بدان معناست که تنظیمات محدودیت دانلود یا کپی برای همه کاربران حذف شده است.
فیلدهایی که ویژگی های دانلود، چاپ و کپی را کنترل می کنند
جدول زیر فیلدهای منبعی را فهرست می drives
که بر عملکرد دانلود، چاپ و کپی تأثیر می گذارد:
میدان | توضیحات | نسخه |
---|---|---|
capabilities.canCopy | آیا کاربر فعلی میتواند فایلها را در درایو مشترک کپی کند یا خیر. | v2 و v3 |
capabilities.canDownload | اینکه آیا کاربر فعلی میتواند فایلها را در درایو مشترک بارگیری کند یا خیر. | v2 و v3 |
capabilities.canChangeCopyRequiresWriterPermission | آیا کاربر فعلی میتواند محدودیت copyRequiresWriterPermission یک درایو مشترک را تغییر دهد یا خیر. | v2 و v3 |
capabilities.canResetDriveRestrictions | آیا کاربر فعلی میتواند محدودیتهای درایو مشترک را به پیشفرض بازنشانی کند یا خیر. | v2 و v3 |
capabilities.canChangeDownloadRestriction | اینکه آیا کاربر فعلی میتواند محدودیت دانلود درایو مشترک را تغییر دهد یا خیر. | فقط نسخه 3 |
restrictions.copyRequiresWriterPermission | آیا گزینههای کپی، چاپ یا دانلود فایلها در درایو مشترک برای خوانندگان و نظر دهندگان غیرفعال است. وقتی true ، فیلد با نام مشابه را برای هر فایلی در داخل این درایو مشترک روی true تنظیم میکند. | v2 و v3 |
restrictions.downloadRestriction | محدودیتهای دانلود اعمال شده توسط مدیران درایو مشترک. | فقط نسخه 3 |
محدودیت پوشه ها
پوشه های درایو مشترک دارای محدودیت های ذخیره سازی هستند. برای اطلاعات، به محدودیتهای درایو مشترک در Google Drive مراجعه کنید.
درپوش مورد
هر پوشه در درایو مشترک کاربر دارای محدودیت 500000 مورد از جمله فایل ها، پوشه ها و میانبرها است.
با رسیدن به حد مجاز، درایو مشترک دیگر نمیتواند موارد را بپذیرد. برای دریافت مجدد فایل ها، کاربران باید به طور دائم موارد را از پوشه حذف کنند. توجه داشته باشید که موارد موجود در سطل زباله در حد مجاز حساب میشوند اما موارد حذف شده برای همیشه اینطور نیست. برای اطلاعات بیشتر، به حذفشدهها یا حذف فایلها و پوشهها مراجعه کنید.
محدودیت عمق پوشه
یک پوشه در درایو مشترک نمیتواند بیش از 100 سطح پوشه تودرتو داشته باشد. این بدان معنی است که یک پوشه فرزند را نمی توان در پوشه ای با عمق بیش از 99 سطح ذخیره کرد. این محدودیت فقط برای پوشه های فرزند اعمال می شود.
تلاش برای افزودن بیش از 100 سطح پوشه، پاسخ کد وضعیت HTTP teamDriveHierarchyTooDeep
را برمیگرداند.