يسرد ملفات المستخدم.
تقبل هذه الطريقة المعلَمة q
، وهي عبارة عن طلب بحث يجمع عبارة واحدة أو أكثر من عبارات البحث. للمزيد من المعلومات، يُرجى الاطّلاع على دليل البحث عن الملفات والمجلدات.
طلب HTTP
GET https://www.googleapis.com/drive/v2/files
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معلمات طلب البحث
المَعلمات | |
---|---|
corpora |
مجموعات العناصر (الملفات/المستندات) التي ينطبق عليها طلب البحث النصوص المتوافقة هي |
corpus |
مهمل: نص العناصر (الملفات/المستندات) التي ينطبق عليها طلب البحث يمكنك استخدام |
driveId |
رقم تعريف مساحة التخزين السحابي المشتركة للبحث |
includeItemsFromAllDrives |
يمكنك اختيار ما إذا كان يجب تضمين كل من "ملفاتي" والعناصر في مساحة التخزين السحابي المشتركة في النتائج. |
includeTeamDriveItems |
متوقّفة نهائيًا: يمكنك استخدام |
maxResults |
الحد الأقصى لعدد الملفات المطلوب عرضها في كل صفحة. ويمكن أن تظهر صفحات نتائج جزئية أو فارغة حتى قبل الوصول إلى نهاية قائمة الملفات. |
orderBy |
قائمة بمفاتيح الترتيب مفصولة بفواصل. المفاتيح الصالحة هي |
pageToken |
الرمز المميز للصفحة للملفات. |
projection |
مهملة: لا تتضمن هذه المعلمة أي وظيفة. |
q |
سلسلة طلب بحث للبحث في الملفات |
spaces |
قائمة مفصولة بفواصل تحتوي على المسافات للاستعلام عنها. القيمتان المسموح بإدراجهما هما |
supportsAllDrives |
ما إذا كان التطبيق الذي يقدّم الطلب متوافقًا مع كل من "ملفاتي" ومساحات التخزين السحابي المشتركة. |
supportsTeamDrives |
متوقّفة نهائيًا: يمكنك استخدام |
teamDriveId |
متوقّفة نهائيًا: يمكنك استخدام |
includePermissionsForView |
تحدد أذونات الملف الشخصي الإضافية التي يتم تضمينها في الرد. يُسمح فقط بالقيمة |
includeLabels |
قائمة مفصولة بفواصل تضم معرّفات التصنيفات المراد تضمينها في الجزء |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة بالملفات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"incompleteSearch": boolean,
"nextLink": string,
"items": [
{
object ( |
الحقول | |
---|---|
nextPageToken |
الرمز المميز للصفحة للصفحة التالية من الملفات. لن يظهر هذا الخيار في حال الوصول إلى نهاية قائمة الملفات. وإذا تم رفض الرمز المميز لأي سبب من الأسباب، يجب تجاهله وإعادة تشغيل التقسيم على صفحات من الصفحة الأولى من النتائج. |
kind |
دائمًا ما تكون |
etag |
علامة ETag للقائمة. |
selfLink |
رابط للرجوع إلى هذه القائمة. |
incompleteSearch |
ما إذا كانت عملية البحث غير مكتملة. إذا كانت الإجابة صحيحة، فقد تكون بعض نتائج البحث مفقودة، نظرًا لعدم البحث في جميع المستندات. وقد يحدث ذلك عند البحث في مساحات تخزين سحابي متعددة باستخدام مجموعة "allDrives"، ولكن يتعذّر البحث في جميع المجموعات. عندما يحدث ذلك، ننصح العملاء بتضييق نطاق طلب البحث من خلال اختيار مجموعة مختلفة مثل "default" أو "drive". |
nextLink |
رابط إلى الصفحة التالية من الملفات. |
items[] |
قائمة الملفات. في حال تعبئة 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.apps.readonly
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
تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.
الجزء الأساسي
عمليات التعداد | |
---|---|
DEFAULT |
تمثّل هذه السمة العناصر التي وصل إليها المستخدم. |
DOMAIN |
العناصر التي تمت مشاركتها مع نطاق المستخدم. |