Google Drive API از چندین نوع اقدام بارگیری و صادرات پشتیبانی می کند که در جدول زیر فهرست شده است:
اقدامات را دانلود کنید |
| ||||
اقدامات صادراتی |
|
قبل از دانلود یا صادر کردن محتوای فایل، بررسی کنید که کاربران می توانند فایل را با استفاده از قسمت capabilities.canDownload
در منبع files
دانلود کنند.
برای توضیح انواع فایل های ذکر شده در اینجا، از جمله فایل های blob و Google Workspace، به انواع فایل مراجعه کنید.
بقیه این راهنما دستورالعمل های دقیقی را برای انجام این نوع اقدامات دانلود و صادرات ارائه می دهد.
دانلود محتوای فایل blob
برای دانلود یک فایل blob ذخیره شده در Drive، از روش files.get
با شناسه فایل برای دانلود و پارامتر URL alt=media
استفاده کنید. پارامتر alt=media
URL به سرور می گوید که دانلود محتوا به عنوان فرمت پاسخ جایگزین درخواست می شود.
پارامتر alt=media
URL یک پارامتر سیستمی است که در همه APIهای Google REST موجود است. اگر از کتابخانه سرویس گیرنده برای Drive API استفاده می کنید، نیازی به تنظیم صریح این پارامتر ندارید.
نمونه کد زیر نحوه استفاده از روش files.get
برای دانلود فایل با کتابخانه های سرویس گیرنده Drive API را نشان می دهد.
جاوا
پایتون
Node.js
PHP
دات نت
این نمونه کد از یک روش کتابخانه ای استفاده می کند که پارامتر URL alt=media
را به درخواست اصلی HTTP اضافه می کند.
دانلود فایلهایی که از برنامه شما شروع میشوند باید با محدودهای مجاز باشند که اجازه دسترسی خواندن به محتوای فایل را بدهد. برای مثال، برنامهای که از محدوده drive.readonly.metadata
استفاده میکند، مجاز به دانلود محتوای فایل نیست. این نمونه کد از محدوده فایل محدود "درایو" استفاده می کند که به کاربران امکان می دهد همه فایل های Drive شما را مشاهده و مدیریت کنند. برای کسب اطلاعات بیشتر درباره حوزههای Drive، به انتخاب حوزههای API Google Drive مراجعه کنید.
کاربران دارای مجوز ویرایش می توانند با تنظیم فیلد copyRequiresWriterPermission
بر روی false
، دانلود توسط کاربران فقط خواندنی را محدود کنند.
فایل هایی که به عنوان توهین آمیز شناسایی شده اند (مانند نرم افزارهای مضر) فقط توسط مالک فایل قابل دانلود هستند. علاوه بر این، پارامتر get
query acknowledgeAbuse=true
باید گنجانده شود تا نشان دهد کاربر خطر دانلود نرمافزار ناخواسته یا سایر فایلهای سوءاستفادهکننده را تایید کرده است. برنامه شما باید قبل از استفاده از این پارامتر پرس و جو به صورت تعاملی به کاربر هشدار دهد.
دانلود جزئی
دانلود جزئی شامل دانلود تنها بخش مشخصی از یک فایل است. با استفاده از محدوده بایت با سربرگ Range
می توانید بخشی از فایلی را که می خواهید دانلود کنید مشخص کنید. به عنوان مثال:
Range: bytes=500-999
محتوای فایل blob را در نسخه قبلی دانلود کنید
برای دانلود محتوای فایلهای blob در نسخه قبلی، از روش revisions.get
با شناسه فایل برای دانلود، شناسه ویرایش و پارامتر URL alt=media
استفاده کنید. پارامتر alt=media
URL به سرور می گوید که دانلود محتوا به عنوان فرمت پاسخ جایگزین درخواست می شود. مشابه files.get
، متد revisions.get
نیز پارامتر درخواست اختیاری acknowledgeAbuse
و هدر Range
را می پذیرد. برای اطلاعات بیشتر درباره بارگیری نسخهها، به مدیریت ویرایشهای فایل مراجعه کنید.
پروتکل درخواست در اینجا نشان داده شده است.
GET https://www.googleapis.com/drive/v3/files/{FILE_ID
}/revisions/{REVISION_ID
}?alt=media
محتوای فایل blob را در مرورگر دانلود کنید
برای دانلود محتوای فایلهای blob ذخیره شده در Drive در یک مرورگر، به جای استفاده از API، از قسمت webContentLink
منبع files
استفاده کنید. در صورتی که کاربر دسترسی دانلودی به فایل داشته باشد، لینک دانلود فایل و محتویات آن برگردانده می شود. می توانید کاربر را به این URL هدایت کنید یا آن را به عنوان یک پیوند قابل کلیک ارائه دهید.
دانلود محتوای فایل blob در طول عملیات طولانی مدت
برای دانلود محتوای فایل های blob در حین عملیات طولانی مدت از روش files.download
با شناسه فایل برای دانلود استفاده کنید. شما می توانید به صورت اختیاری شناسه ویرایش را تنظیم کنید. این تنها راه برای دانلود فایل های Google Vids است. برای اطلاعات بیشتر، به مدیریت عملیات طولانی مدت مراجعه کنید.
محتوای سند Google Workspace را صادر کنید
برای صادر کردن محتوای بایت سند Google Workspace، از روش files.export
با شناسه فایل برای صادرات و نوع MIME صحیح استفاده کنید. محتوای صادر شده به 10 مگابایت محدود شده است.
نمونه کد زیر نحوه استفاده از روش files.export
را برای صادر کردن یک سند Google Workspace در قالب PDF با استفاده از کتابخانه های سرویس گیرنده Drive API نشان می دهد:
جاوا
پایتون
Node.js
PHP
دات نت
این نمونه کد از محدوده drive
محدود استفاده می کند که به کاربران امکان می دهد همه فایل های Drive شما را مشاهده و مدیریت کنند. برای کسب اطلاعات بیشتر درباره حوزههای Drive، به انتخاب حوزههای API Google Drive مراجعه کنید.
نمونه کد نیز نوع صادرات MIME را به عنوان application/pdf
اعلام می کند. برای فهرست کاملی از همه انواع MIME صادراتی پشتیبانی شده برای هر سند Google Workspace، به صادرات انواع MIME برای اسناد Google Workspace مراجعه کنید.
محتوای سند Google Workspace را در مرورگر صادر کنید
برای صادر کردن محتوای سند Google Workspace در یک مرورگر، از قسمت exportLinks
منبع files
استفاده کنید. بسته به نوع سند، پیوندی برای دانلود فایل و محتویات آن برای هر نوع MIME موجود برگردانده می شود. می توانید کاربر را به یک URL هدایت کنید یا آن را به عنوان یک پیوند قابل کلیک ارائه دهید.
محتوای سند Google Workspace را در نسخه قبلی در مرورگر صادر کنید
برای صادر کردن محتوای سند Google Workspace در نسخه قبلی در یک مرورگر، از روش revisions.get
با شناسه فایل برای دانلود و شناسه ویرایش برای ایجاد پیوند صادراتی استفاده کنید که میتوانید دانلود را از آن انجام دهید. در صورتی که کاربر دسترسی دانلودی به فایل داشته باشد، لینک دانلود فایل و محتویات آن برگردانده می شود. می توانید کاربر را به این URL هدایت کنید یا آن را به عنوان یک پیوند قابل کلیک ارائه دهید.
در طول عملیات طولانی مدت، محتوای سند Google Workspace را صادر کنید
برای صادر کردن محتوای سند Google Workspace در طول عملیات طولانی مدت، از روش files.download
با شناسه فایل برای دانلود و شناسه ویرایش استفاده کنید. برای اطلاعات بیشتر، به مدیریت عملیات طولانی مدت مراجعه کنید.