Method: files.download

محتوای یک فایل را دانلود می کند. عملیات به مدت 24 ساعت از زمان ایجاد معتبر است.

درخواست HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/download

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
fileId

string

مورد نیاز. شناسه فایل برای دانلود.

پارامترهای پرس و جو

پارامترها
mimeType

string

اختیاری. نوع MIME فایل باید به عنوان دانلود شود. این فیلد فقط هنگام بارگیری اسناد Google Workspace قابل تنظیم است. برای لیست انواع MIME پشتیبانی شده ، انواع فایل های MIME را برای اسناد Google Workspace صادر کنید . اگر تنظیم نشود، یک سند Google Workspace با یک نوع MIME پیش‌فرض دانلود می‌شود. نوع پیش‌فرض MIME ممکن است در آینده تغییر کند.

revisionId

string

اختیاری. شناسه ویرایش فایل برای دانلود. این فیلد را فقط هنگام دانلود فایل‌های blob، Google Docs و Google Sheets می‌توان تنظیم کرد. اگر دانلود نسخه خاصی روی فایل پشتیبانی نشود، INVALID_ARGUMENT را برمی‌گرداند.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Operation است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly

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