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 description,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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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