Method: files.list

רשימה של הקבצים של המשתמש.

השיטה הזו מקבלת את הפרמטר q, שהוא שאילתה לחיפוש שמשלבת מונח חיפוש אחד או יותר. מידע נוסף זמין במדריך חיפוש קבצים ותיקיות.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של שאילתה

פרמטרים
corpora

string

גוף הפריטים (קבצים/מסמכים) שעליהם חלה השאילתה. הגוף הנתמך הוא default, ‏ domain, ‏ drive ו-allDrives. מומלץ להשתמש ב-default או ב-drive במקום ב-allDrives כדי לשפר את היעילות.
corpus
(deprecated)

enum (Corpus)

הוצא משימוש: גוף הפריטים (קבצים/מסמכים) שעליהם חלה השאילתה. במקום זאת, אתם צריכים להשתמש ב-corpora.
driveId

string

המזהה של האחסון השיתופי שבו רוצים לחפש.
includeItemsFromAllDrives

boolean

אם המערכת תכלול בתוצאות גם פריטים מהתיקייה 'האחסון שלי' וגם פריטים מתיקיות אחסון שיתופי.
includeTeamDriveItems
(deprecated)

boolean

האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-includeItemsFromAllDrives.
maxResults

integer

המספר המקסימלי של קבצים להצגה בכל דף. יכול להיות שיהיו דפי תוצאות חלקיים או ריקים עוד לפני שמגיעים לסוף רשימת הקבצים.
orderBy

string

רשימה מופרדת בפסיקים של מפתחות מיון. המפתחות התקינים הם:

  • createdDate: מתי הקובץ נוצר.
  • folder: מזהה התיקייה. השדה הזה ממוין לפי סדר אלפביתי.
  • lastViewedByMeDate: הפעם האחרונה שבה המשתמש צפה בקובץ.
  • modifiedByMeDate: הפעם האחרונה שבה המשתמש שינה את הקובץ.
  • modifiedDate: הפעם האחרונה שבה מישהו שינה את הקובץ.
  • quotaBytesUsed: מספר הבייטים של מכסת האחסון שהקובץ השתמש בהם.
  • recency: חותמת הזמן האחרונה משדות התאריך-שעה של הקובץ.
  • sharedWithMeDate: מתי הקובץ שותף עם המשתמש, אם רלוונטי.
  • starred: אם המשתמש סימן את הקובץ בכוכב.
  • title: שם הקובץ. השדה הזה ממוין לפי סדר אלפביתי, למשל 1, 12, 2, 22.
  • title_natural: שם הקובץ. השדה הזה ממוין לפי סדר מיון טבעי, כלומר 1, 2, 12, 22.

כברירת מחדל, כל מפתח ממוין בסדר עולה, אבל אפשר להפוך את הסדר באמצעות המאפיין 'desc'. דוגמה לשימוש: ?orderBy=folder,modifiedDate desc,title.

לתשומת ליבכם: כרגע יש הגבלה על משתמשים שיש להם כמיליון קבצים, שבהם המערכת מתעלמת מסדר המיון המבוקש.
pageToken

string

אסימון דף לקבצים.
projection
(deprecated)

enum (Projection)

הפרמטר הזה הוצא משימוש: אין לו פונקציה.
q

string

מחרוזת שאילתה לחיפוש קבצים.
spaces

string

רשימה מופרדת בפסיקים של מרחבים משותפים שרוצים לשלוח אליהם שאילתה. הערכים הנתמכים הם drive ו-appDataFolder.
supportsAllDrives

boolean

האם האפליקציה המבקשת תומכת גם בתיקיות 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
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.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

היקפי הרשאה מסוימים מוגבלים, ונדרש הערכת אבטחה כדי שהאפליקציה שלכם תוכל להשתמש בהם. מידע נוסף זמין במדריך ההרשאות.

קורפוס

טיפוסים בני מנייה (enum)
DEFAULT הפריטים שהמשתמש נכנס אליהם.
DOMAIN פריטים ששותפו עם הדומיין של המשתמש.