Method: drives.list

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

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
pageSize

integer

حداکثر تعداد درایوهای مشترک برای بازگشت در هر صفحه.

pageToken

string

نشانه صفحه برای درایوهای مشترک.

q

string

رشته پرس و جو برای جستجوی درایوهای مشترک.

useDomainAdminAccess

boolean

درخواست را به عنوان مدیر دامنه صادر کنید. اگر روی true تنظیم شود، تمام درایوهای مشترک دامنه ای که درخواست کننده در آن مدیر است، برگردانده می شود. اگر روی false (پیش‌فرض) تنظیم شود، حداکثر 1000 برگردانده می‌شود، حتی اگر تعداد بیشتری وجود داشته باشد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

لیستی از درایوهای مشترک

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی 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

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