Method: children.list

בתיבת הדו-שיח הזו מפורטים הצאצאים של תיקייה.

בקשת HTTP

GET https://www.googleapis.com/drive/v2/files/{folderId}/children

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

פרמטרים של נתיב

פרמטרים
folderId

string

המזהה של התיקייה.

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

פרמטרים
maxResults

integer

מספר הילדים המקסימלי להחזרה.
orderBy

string

רשימה של מפתחות מיון שמופרדים בפסיקים. המפתחות החוקיים הם createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred ו-title. כל מקש ממיין בסדר עולה כברירת מחדל, אבל אפשר להפוך את המקשים באמצעות מקש הצירוף desc. שימוש לדוגמה: ?orderBy=folder,modifiedDate desc,title. הערה: קיימת מגבלה נוכחית על משתמשים עם כמיליון קבצים, שבה המערכת מתעלמת מסדר המיון המבוקש.
pageToken

string

אסימון דף לילדים.
q

string

מחרוזת שאילתה לחיפוש צאצאים.

גוף הבקשה

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

גוף התשובה

רשימה של צאצאים של קובץ.

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

ייצוג JSON 
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (ChildReference)
    }
  ]
}
שדות
nextPageToken

string

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

string

הערך הוא תמיד drive#childList.
etag

string

ה-ETag של הרשימה.
items[]

object (ChildReference)

רשימת הילדים. אם nextPageToken מאוכלס, יכול להיות שהרשימה הזו חלקית וצריך לאחזר דף נוסף של תוצאות.

היקפי ההרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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