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
{
  "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

برخی از دامنه ها محدود هستند و برای استفاده از برنامه شما به ارزیابی امنیتی نیاز دارند. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.