Method: drives.list

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
pageSize

integer

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

string

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

string

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

boolean

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

גוף הבקשה

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

גוף התשובה

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

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

ייצוג 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

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