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