يعرض ملفات المستخدم.
تقبل هذه الطريقة المعلمة q
، وهي طلب بحث يجمع بين عبارة بحث واحدة أو أكثر. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على دليل البحث عن الملفات والمجلدات.
طلب HTTP
GET https://www.googleapis.com/drive/v2/files
يستخدم عنوان URL بنية gRPC Transcode.
معلمات طلب البحث
المَعلمات | |
---|---|
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"، ولكن تعذّر البحث في جميع المجموعات. وعند حدوث ذلك، ننصح العملاء بتضييق نطاق طلب البحث من خلال اختيار مجموعة مختلفة مثل "تلقائي" أو "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 |
العناصر التي تمت مشاركتها في نطاق المستخدم. |