Method: drives.list

تعرِض هذه السمة مساحات التخزين السحابي المشتركة الخاصة بالمستخدم.

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

طلب HTTP

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

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

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

المعلمات
pageSize

integer

الحد الأقصى لعدد مساحات Drive المشتركة المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة.

إذا لم يتم تحديدها، سيتم عرض 10 مساحات تخزين سحابي مشتركة كحد أقصى.

الحد الأقصى للقيمة هو 100، وسيتم فرض القيمة 100 على القيم التي تزيد عن 100.
pageToken

string

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

string

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

boolean

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

نص الطلب

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

نص الاستجابة

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

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

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

object (Drive)

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

string

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

string

تحدّد نوع المورد. القيمة: السلسلة الثابتة "drive#driveList".

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

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

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