רשימת תיקיות האחסון השיתופי של המשתמש.
השיטה הזו מקבלת את הפרמטר q
, שהוא שאילתת חיפוש שמשלבת מונח חיפוש אחד או יותר. מידע נוסף זמין במדריך חיפוש תיקיות אחסון שיתופי.
בקשת HTTP
GET https://www.googleapis.com/drive/v2/drives
בכתובת ה-URL נעשה שימוש בתחביר המרת 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
חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.