Method: files.list

تعرض هذه السمة ملفات المستخدم. لمزيد من المعلومات، يُرجى الاطّلاع على البحث عن الملفات والمجلدات.

تقبل هذه الطريقة المَعلمة q، وهي طلب بحث يجمع بين عبارة بحث واحدة أو أكثر.

تعرض هذه الطريقة جميع الملفات تلقائيًا، بما في ذلك الملفات المحذوفة. إذا كنت لا تريد أن تظهر الملفات المحذوفة في القائمة، استخدِم مَعلمة طلب البحث trashed=false لإزالة الملفات المحذوفة من النتائج.

طلب HTTP

GET https://www.googleapis.com/drive/v3/files

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات طلب البحث

المعلمات
corpora

string

تحدِّد هذه السمة مجموعة من العناصر (الملفات أو المستندات) التي ينطبق عليها طلب البحث. تشمل العناصر المتوافقة ما يلي:

  • user
  • domain
  • drive
  • allDrives

استخدِم user أو drive بدلاً من allDrives لتوفير الطاقة. يتم ضبط مجموعة النصوص اللغوية تلقائيًا على user. ومع ذلك، يمكن أن يتغيّر ذلك حسب الفلتر الذي تم ضبطه من خلال المَعلمة q. لمزيد من المعلومات، يُرجى الاطّلاع على تنظيم الملفات.
corpus
(deprecated)

enum (Corpus)

تم إيقاف هذه السمة نهائيًا: مصدر الملفات المطلوب إدراجها. يمكنك استخدام corpora بدلاً من ذلك.
driveId

string

رقم تعريف مساحة التخزين السحابي المشتركة التي سيتم البحث فيها
includeItemsFromAllDrives

boolean

تحديد ما إذا كان يجب تضمين العناصر من "ملفاتي" ومساحة التخزين السحابي المشتركة في النتائج
includeTeamDriveItems
(deprecated)

boolean

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة includeItemsFromAllDrives بدلاً منها.
orderBy

string

تمثّل هذه المَعلمة قائمة مفصولة بفواصل لمفاتيح الترتيب. المفاتيح الصالحة هي:

  • createdTime: وقت إنشاء الملف تجنَّب استخدام هذا المفتاح للاستعلامات عن مجموعات كبيرة من العناصر لأنّ ذلك قد يؤدي إلى انتهاء المهلة أو حدوث مشاكل أخرى. بالنسبة إلى الترتيب حسب الوقت في مجموعات العناصر الكبيرة، استخدِم modifiedTime بدلاً من ذلك.
  • folder: رقم تعريف المجلد يتم ترتيب هذا الحقل أبجديًا.
  • modifiedByMeTime: آخر مرة عدّل فيها المستخدم الملف.
  • modifiedTime: آخر مرة عدَّل فيها أي مستخدم الملف
  • name: اسم الملف يتم ترتيب هذا الحقل أبجديًا، أي 1 و12 و2 و22.
  • name_natural: اسم الملف يتم ترتيب هذا الحقل باستخدام ترتيب الفرز الطبيعي، أي 1 و2 و12 و22.
  • quotaBytesUsed: عدد وحدات البايت لمساحة التخزين المتوفّرة التي يستخدمها الملف
  • recency: الطابع الزمني الأخير من حقول التاريخ والوقت في الملف
  • sharedWithMeTime: الوقت الذي تمت فيه مشاركة الملف مع المستخدم، إذا كان ذلك منطبقًا
  • ‫starred: ما إذا وضع المستخدم نجمة على الملف.
  • viewedByMeTime: آخر مرة اطّلع فيها المستخدم على الملف

يتم ترتيب كل مفتاح تصاعديًا تلقائيًا، ولكن يمكن عكس الترتيب باستخدام المعدِّل desc. مثال على الاستخدام: ?orderBy=folder,modifiedTime desc,name.
pageSize

integer

الحد الأقصى لعدد الملفات التي سيتم عرضها في كل صفحة من المحتمل أن تكون صفحات النتائج جزئية أو فارغة حتى قبل الوصول إلى نهاية قائمة الملفات.
pageToken

string

الرمز المميز لمواصلة طلب قائمة سابق في الصفحة التالية يجب ضبط هذه السمة على قيمة nextPageToken من الاستجابة السابقة.
q

string

طلب بحث لفلترة نتائج الملفات للاطّلاع على البنية المتوافقة، يُرجى الرجوع إلى البحث عن الملفات والمجلدات.
spaces

string

قائمة مفصولة بفواصل تتضمّن المساحات المطلوب البحث فيها ضمن مجموعات النصوص القيمتان المسموح بإدراجهما هما drive وappDataFolder. لمزيد من المعلومات، يُرجى الاطّلاع على تنظيم الملفات.
supportsAllDrives

boolean

تحديد ما إذا كان التطبيق الذي يطلب الوصول يتيح استخدام كل من "ملفاتي" ومساحات التخزين السحابي المشتركة
supportsTeamDrives
(deprecated)

boolean

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة supportsAllDrives بدلاً منها.
teamDriveId
(deprecated)

string

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة driveId بدلاً منها.
includePermissionsForView

string

تحدّد هذه السمة أذونات العرض الإضافية المطلوب تضمينها في الردّ. يُسمح فقط بالقيمة published.
includeLabels

string

قائمة مفصولة بفواصل تتضمّن معرّفات التصنيفات المطلوب تضمينها في الجزء labelInfo من الردّ.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

قائمة بالملفات

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "files": [
    {
      object (File)
    }
  ],
  "nextPageToken": string,
  "kind": string,
  "incompleteSearch": boolean
}
الحقول
files[]

object (File)

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

string

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

string

تحدّد نوع المورد. القيمة: السلسلة الثابتة "drive#fileList".

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

يجب توفير أحد نطاقات OAuth التالية:

  • 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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

الجزء الأساسي

عمليات التعداد
user الملفات التي يملكها المستخدم أو التي تمت مشاركتها معه
domain الملفات التي تمت مشاركتها مع نطاق المستخدم