Method: drives.list

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

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

בקשת HTTP

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

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

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

פרמטרים
maxResults

integer

המספר המקסימלי של תיקיות באחסון השיתופי שיוחזרו בכל דף.
pageToken

string

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

string

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

boolean

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (Drive)

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

string

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

string

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

היקפי הרשאה

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

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

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