מציין את הצאצאים של תיקייה.
בקשת HTTP
GET https://www.googleapis.com/drive/v2/files/{folderId}/children
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
folderId |
המזהה של התיקייה. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
maxResults |
מספר הילדים המקסימלי שניתן להחזיר. |
orderBy |
רשימה של מפתחות מיון שמופרדים בפסיקים. המפתחות החוקיים הם |
pageToken |
אסימון דף לילדים. |
q |
מחרוזת שאילתה לחיפוש צאצאים. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
רשימת צאצאים של קובץ.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
שדות | |
---|---|
nextPageToken |
אסימון הדף של דף הצאצא הבא. אם רשימת הילדים תסתיים, השדה הזה לא יופיע. אם האסימון יידחה מסיבה כלשהי, יש לבטל אותו ולהתחיל את העימוד מחדש מהדף הראשון של תוצאות החיפוש. |
kind |
הערך הוא תמיד |
etag |
ה-ETag של הרשימה. |
selfLink |
קישור בחזרה לרשימה זו. |
nextLink |
קישור לדף הבא של חשבון הילדים. |
items[] |
רשימת הילדים. אם השדה 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
חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.