Method: drives.list

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

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

בקשת HTTP

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

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

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

פרמטרים
pageSize

integer

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

string

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

string

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

boolean

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (Drive)

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

string

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

string

מזהה את סוג המשאב. הערך: המחרוזת הקבועה "drive#driveList".

היקפי הרשאה

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

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

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