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

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