Method: files.get

فراداده یا محتوای یک فایل را با شناسه دریافت می کند.

اگر پارامتر URL alt=media را ارائه دهید، پاسخ شامل محتوای فایل در بدنه پاسخ می شود. دانلود محتوا با alt=media فقط در صورتی کار می کند که فایل در Drive ذخیره شده باشد. برای دانلود Google Docs، Sheets و Slides به جای آن files.export استفاده کنید. برای اطلاعات بیشتر، دانلود و صادر کردن فایل‌ها را ببینید.

درخواست HTTP

GET https://www.googleapis.com/drive/v2/files/{fileId}

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

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

مولفه های
fileId

string

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

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

مولفه های
acknowledgeAbuse

boolean

این که آیا کاربر خطر دانلود بدافزار شناخته شده یا سایر فایل های توهین آمیز را تأیید می کند. این تنها زمانی قابل اعمال است که پارامتر alt روی media تنظیم شده باشد و کاربر مالک فایل یا سازمان دهنده درایو مشترکی باشد که فایل در آن قرار دارد.

projection
(deprecated)

enum ( Projection )

Deprecated: این پارامتر عملکردی ندارد.

revisionId

string

شناسه نسخه ای را که باید دانلود شود را مشخص می کند. نادیده گرفته می شود مگر اینکه alt=media مشخص شده باشد.

supportsAllDrives

boolean

اینکه آیا برنامه درخواست کننده هم از My Drives و هم درایوهای مشترک پشتیبانی می کند.

supportsTeamDrives
(deprecated)

boolean

منسوخ شده: به جای آن از supportsAllDrives استفاده کنید.

updateViewedDate
(deprecated)

boolean

منسوخ شده: از files.update با modifiedDateBehavior=noChange, updateViewedDate=true و بدنه درخواست خالی استفاده کنید.

includePermissionsForView

string

مشخص می کند که کدام مجوزهای اضافی در پاسخ گنجانده شود. فقط published پشتیبانی می شود.

includeLabels

string

فهرستی از شناسه‌های برچسب‌هایی که با کاما از هم جدا شده‌اند تا در قسمت labelInfo پاسخ قرار داده شوند.

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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