Method: drives.list

רשימה של תיקיות האחסון השיתופי של המשתמש.

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

בקשת HTTP

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

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

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

פרמטרים
maxResults

integer

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

pageToken

string

אסימון דף של תיקיות אחסון שיתופי.

q

string

מחרוזת שאילתה לחיפוש תיקיות אחסון שיתופי.

useDomainAdminAccess

boolean

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

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

רשימת תיקיות אחסון שיתופי.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON
{
  "nextPageToken": string,
  "kind": string,
  "items": [
    {
      object (Drive)
    }
  ]
}
שדות
nextPageToken

string

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

kind

string

הערך הזה תמיד הוא drive#driveList

items[]

object (Drive)

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

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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

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