Method: drives.list

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

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

בקשת HTTP

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

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

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

פרמטרים
pageSize

integer

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

string

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

string

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

boolean

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

גוף הבקשה

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

גוף התשובה

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

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

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

string

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

string

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

object (Drive)

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

היקפי הרשאה

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

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

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