Method: drives.list

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

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

طلب HTTP

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

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

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

المعلمات
pageSize

integer

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

string

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

string

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

boolean

قدِّم الطلب بصفتك مشرف نطاق. في حال ضبطها على "صحيح"، يتم عرض جميع مساحات التخزين السحابي المشتركة في النطاق الذي يكون فيه المُقدّم للطلب مشرفًا. إذا تم ضبطها على false (القيمة التلقائية)، يتم عرض 1,000 بحد أقصى، حتى إذا كان هناك المزيد.

نص الطلب

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

نص الاستجابة

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

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

تمثيل 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

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