ایجاد و مدیریت فایل ها

این راهنما نحوه ایجاد و مدیریت فایل‌ها در Google Drive را توضیح می‌دهد.

فایل ایجاد کنید

برای ایجاد فایلی در Drive که حاوی فراداده یا محتوا نباشد، از روش files.create بدون پارامتر استفاده کنید. به فایل یک kind drive.file ، یک id ، name "Untitled" و یک mimeType of application/octet-stream داده می شود. uploadType به‌عنوان مورد نیاز علامت‌گذاری شده است، اما به صورت پیش‌فرض روی media است، بنابراین در واقع نیازی به ارائه آن ندارید.

برای اطلاعات بیشتر درباره محدودیت‌های فایل Drive، محدودیت‌های فایل و پوشه را ببینید.

فایل های فقط متادیتا ایجاد کنید

فایل‌های فقط متادیتا حاوی محتوایی نیستند. فراداده داده‌ای است (مانند name ، mimeType ، و createdTime ) که فایل را توصیف می‌کند. فیلدهایی مانند name برای کاربر ناشناس هستند و برای هر کاربر یکسان ظاهر می شوند، در حالی که فیلدهایی مانند viewedByMeTime حاوی مقادیر خاص کاربر هستند.

یکی از نمونه‌های یک فایل فقط فراداده، پوشه‌ای با نوع MIME application/vnd.google-apps.folder است. برای اطلاعات بیشتر، به ایجاد و پر کردن پوشه‌ها مراجعه کنید. مثال دیگر میانبری است که با نوع MIME application/vnd.google-apps.shortcut به فایل دیگری در Drive اشاره می کند. برای اطلاعات بیشتر، به ایجاد میانبر برای فایل Drive مراجعه کنید.

مدیریت تصاویر کوچک

ریز عکسها به کاربران کمک می کند فایل های Drive را شناسایی کنند. Drive می‌تواند به‌طور خودکار برای انواع فایل‌های رایج تصاویر کوچک تولید کند یا می‌توانید یک تصویر کوچک ایجاد شده توسط برنامه خود ارائه دهید. برای اطلاعات بیشتر، آپلود ریز عکسها را ببینید.

یک فایل موجود را کپی کنید

برای کپی کردن یک فایل و اعمال هرگونه به روز رسانی درخواستی، از روش files.copy استفاده کنید. برای پیدا کردن fileId برای کپی کردن، از روش files.list استفاده کنید.

توجه داشته باشید که برای تأیید تماس باید از یک محدوده Drive API مناسب استفاده کنید. برای اطلاعات بیشتر درباره حوزه‌های Drive، به انتخاب حوزه‌های API Google Drive مراجعه کنید.

محدودیت ها و ملاحظات

همانطور که برای کپی کردن فایل ها آماده می شوید، به این محدودیت ها و ملاحظات توجه کنید:

  • مجوزها :

    • محدودیت فایل copyRequiresWriterPermission تعیین می کند که چه کسی می تواند فایل را کپی کند. برای اطلاعات بیشتر، به جلوگیری از دانلود، چاپ یا کپی کردن فایل توسط کاربران مراجعه کنید.
    • قسمت capabilities/canCopy یک منبع files تعیین می کند که آیا کاربر می تواند یک فایل را کپی کند یا خیر. برای اطلاعات بیشتر، به قابلیت ها مراجعه کنید.
    • کاربری که کپی را ایجاد کرده مالک فایل کپی شده است. هیچ تنظیمات اشتراک گذاری دیگری از فایل منبع تکرار نمی شود. اگر کپی در یک پوشه مشترک ایجاد شود، مجوزهای آن پوشه را به ارث می برد.
    • ممکن است مالکیت فایل کپی شده تغییر کند و کپی تنظیمات اشتراک فایل اصلی را به ارث نبرد. این تنظیمات ممکن است نیاز به بازنشانی داشته باشند.

  • مدیریت فایل :

    • برخی از فایل‌ها، مانند میانبرهای شخص ثالث ، هرگز نمی‌توانند کپی شوند.
    • شما فقط می توانید یک فایل را در یک پوشه والد کپی کنید. تعیین چند والدین پشتیبانی نمی‌شود. اگر فیلد parents مشخص نشده باشد، فایل هر پدر و مادر قابل کشف را از فایل منبع به ارث می برد.
    • حتی اگر یک پوشه یک نوع فایل است، شما نمی توانید یک پوشه را کپی کنید. در عوض، یک پوشه مقصد ایجاد کنید و فیلد parents فایل های موجود را روی پوشه مقصد تنظیم کنید. سپس می توانید پوشه منبع اصلی را حذف کنید.
    • مگر اینکه نام فایل جدیدی مشخص شود، روش files.copy فایلی با همان نام اصلی تولید می کند.
    • استفاده بیش از حد از files.copy می‌تواند منجر به فراتر رفتن از محدودیت‌های سهمیه Drive API شما شود. برای اطلاعات بیشتر، محدودیت‌های استفاده را ببینید.

در اینجا چند مرحله بعدی وجود دارد که ممکن است امتحان کنید: