Method: drives.list

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

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

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

المَعلمات
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

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