Method: children.list

רשימה של הילדים בתיקייה.

בקשת HTTP

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

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

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

פרמטרים
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 
{
  "items": [
    {
      object (ChildReference)
    }
  ],
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "nextLink": string
}
שדות
items[]

object (ChildReference)

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

string

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

string

הנתיב הזה תמיד drive#childList.
etag

string

תג ה-ETag של הרשימה.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של 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

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