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=مجلد,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

يتم فرض قيود على بعض النطاقات وتتطلب تقييمًا أمنيًا لتطبيقك حتى يستخدمها. لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.