Method: files.list

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

این روش پارامتر q را می پذیرد، که عبارت جستجویی است که یک یا چند عبارت جستجو را ترکیب می کند. برای اطلاعات بیشتر، راهنمای جستجوی فایل‌ها و پوشه‌ها را ببینید.

درخواست HTTP

GET https://www.googleapis.com/drive/v2/files

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

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

مولفه های
corpora

string

بدنه موارد (فایل ها/اسناد) که پرس و جو در مورد آنها اعمال می شود. بدنه های پشتیبانی شده default ، domain ، drive و allDrives هستند. برای کارایی default یا drive به allDrives ترجیح دهید.

corpus
(deprecated)

enum ( Corpus )

منسوخ شده: مجموعه موارد (فایل ها/اسناد) که پرس و جو در مورد آنها اعمال می شود. به جای آن corpora استفاده کنید.

driveId

string

شناسه درایو مشترک برای جستجو.

includeItemsFromAllDrives

boolean

آیا هر دو مورد My Drive و درایو مشترک باید در نتایج گنجانده شوند یا خیر.

includeTeamDriveItems
(deprecated)

boolean

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

maxResults

integer

حداکثر تعداد فایل برای بازگشت در هر صفحه. صفحات نتیجه جزئی یا خالی حتی قبل از رسیدن به انتهای لیست فایل ها امکان پذیر است.

orderBy

string

فهرستی از کلیدهای مرتب سازی جدا شده با کاما. کلیدهای معتبر createdDate می شوندDate , folder , lastViewedByMeDate , modifiedByMeDate , modifiedDate , quotaBytesUsed , recency , sharedWithMeDate , starred , title و title_natural . هر کلید به صورت پیش‌فرض صعودی مرتب‌سازی می‌کند، اما ممکن است با تغییردهنده desc معکوس شود. مثال استفاده: ?orderBy=folder,modifiedDate desc, title. لطفاً توجه داشته باشید که در حال حاضر محدودیتی برای کاربرانی با تقریباً یک میلیون فایل وجود دارد که در آنها ترتیب مرتب سازی درخواستی نادیده گرفته می شود.

pageToken

string

نشانه صفحه برای فایل ها

projection
(deprecated)

enum ( Projection )

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

q

string

رشته پرس و جو برای جستجوی فایل ها.

spaces

string

فهرستی از فضاهای پرس و جو جدا شده با کاما. مقادیر پشتیبانی شده عبارتند از drive و appDataFolder .

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

teamDriveId
(deprecated)

string

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

includePermissionsForView

string

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

includeLabels

string

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

درخواست بدن

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

بدن پاسخگو

لیستی از فایل ها

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

نمایندگی JSON
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "incompleteSearch": boolean,
  "nextLink": string,
  "items": [
    {
      object (File)
    }
  ]
}
زمینه های
nextPageToken

string

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

kind

string

این همیشه drive#fileList است.

etag

string

ETag لیست.

items[]

object ( File )

لیست فایل ها اگر nextPageToken پر شده باشد، این لیست ممکن است ناقص باشد و یک صفحه اضافی از نتایج باید واکشی شود.

محدوده مجوز

به یکی از حوزه های 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.apps.readonly
  • https://www.googleapis.com/auth/drive.file
  • 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

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

مجموعه نوشته ها

Enums
DEFAULT مواردی که کاربر به آنها دسترسی داشته است.
DOMAIN موارد به اشتراک گذاشته شده در دامنه کاربر.