Method: drives.list

درایوهای اشتراکی کاربر را فهرست می‌کند.

این روش پارامتر q را می‌پذیرد، که یک عبارت جستجو است که یک یا چند عبارت جستجو را ترکیب می‌کند. برای اطلاعات بیشتر، به راهنمای جستجوی درایوهای مشترک مراجعه کنید.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای پرس و جو

پارامترها
pageSize

integer

حداکثر تعداد درایوهای اشتراکی برای برگرداندن. سرویس ممکن است کمتر از این مقدار را برگرداند.

اگر مشخص نشده باشد، حداکثر ۱۰ درایو مشترک بازگردانده خواهد شد.

حداکثر مقدار ۱۰۰ است؛ مقادیر بالاتر از ۱۰۰ به اجبار به ۱۰۰ کاهش داده می‌شوند.

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

برخی از حوزه‌ها محدود شده‌اند و برای استفاده برنامه شما از آنها، ارزیابی امنیتی لازم است. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.