רשימה של תיקיות האחסון השיתופי של המשתמש.
השיטה הזו מקבלת את הפרמטר q
, שהוא שאילתה לחיפוש שמשלבת מונח חיפוש אחד או יותר. מידע נוסף זמין במדריך חיפוש תיקיות אחסון שיתופי.
בקשת HTTP
GET https://www.googleapis.com/drive/v2/drives
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
maxResults |
המספר המקסימלי של אחסונים משותפים שיוצגו בכל דף. |
pageToken |
אסימון דף של תיקיות אחסון שיתופי. |
q |
מחרוזת שאילתה לחיפוש תיקיות אחסון שיתופי. |
useDomainAdminAccess |
שליחת הבקשה כאדמין דומיין. אם הערך מוגדר כ-true, המערכת תחזיר את כל האחסונים השיתופיים בדומיין שבו מבצע הבקשה הוא אדמין. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
רשימת תיקיות אחסון שיתופי.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{
"nextPageToken": string,
"kind": string,
"items": [
{
object ( |
שדות | |
---|---|
nextPageToken |
אסימון הדף לדף הבא של תיקיות האחסון השיתופי. השדה הזה לא יופיע אם הגעתם לסוף הרשימה. אם האסימון נדחה מסיבה כלשהי, צריך להשליך אותו ולהתחיל מחדש את חלוקת הדפים מדף התוצאות הראשון. |
kind |
הערך הזה תמיד הוא |
items[] |
רשימת האחסון השיתופי. אם השדה nextPageToken מאוכלס, יכול להיות שהרשימה הזו חלקית וצריך לאחזר דף נוסף של תוצאות. |
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.readonly
היקפי הרשאה מסוימים מוגבלים, ונדרש הערכת אבטחה כדי שהאפליקציה שלכם תוכל להשתמש בהם. מידע נוסף זמין במדריך ההרשאות.