Method: drives.list

يسرد مساحات التخزين السحابي المشتركة للمستخدم.

تقبل هذه الطريقة المعلَمة q، وهي عبارة عن طلب بحث يجمع عبارة واحدة أو أكثر من عبارات البحث. للمزيد من المعلومات، يُرجى الاطّلاع على دليل البحث عن مساحات التخزين السحابي المشتركة.

طلب HTTP

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

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

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

المَعلمات
pageSize

integer

الحدّ الأقصى لعدد مساحات التخزين السحابي المشتركة التي يمكن عرضها في كل صفحة
pageToken

string

الرمز المميز للصفحة لمساحات التخزين السحابي المشتركة
q

string

سلسلة طلب بحث للبحث في مساحات التخزين السحابي المشتركة
useDomainAdminAccess

boolean

أصدر الطلب كمشرف نطاق. في حال ضبط هذه السياسة على "صحيح"، سيتم عرض جميع مساحات التخزين السحابي المشتركة للنطاق الذي يكون مقدِّم الطلب مشرفًا فيه.

نص الطلب

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

نص الاستجابة

قائمة بمساحات التخزين السحابي المشتركة

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

تمثيل JSON 
{
  "nextPageToken": string,
  "kind": string,
  "drives": [
    {
      object (Drive)
    }
  ]
}
الحقول
nextPageToken

string

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

string

تحدد نوع هذا المورد. القيمة: السلسلة الثابتة "drive#driveList".
drives[]

object (Drive)

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

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly

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