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

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