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

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