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 
{
  "items": [
    {
      object (ChildReference)
    }
  ],
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "nextLink": string
}
الحقول
items[]

object (ChildReference)

تمثّل هذه السمة قائمة الأطفال. إذا تم ملء nextPageToken، قد تكون هذه القائمة غير مكتملة ويجب استرداد صفحة إضافية من النتائج.
nextPageToken

string

الرمز المميّز للصفحة التالية من العناصر الفرعية لن يظهر هذا الحقل إذا تم الوصول إلى نهاية قائمة الأطفال. إذا تم رفض الرمز المميّز لأي سبب، يجب تجاهله وإعادة بدء التقسيم على صفحات من الصفحة الأولى من النتائج.
kind

string

يكون هذا الخيار drive#childList دائمًا.
etag

string

تمثّل هذه السمة علامة ETag الخاصة بالقائمة.

نطاقات الأذونات

يجب توفير أحد نطاقات 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

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