Method: drives.list

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

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

בקשת HTTP

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

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

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

פרמטרים
pageSize

integer

מספר האחסונים השיתופיים המקסימלי שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה.

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

הערך המקסימלי הוא 100. ערכים גבוהים יותר יומרו ל-100.
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

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