Method: permissions.list

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

درخواست HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions

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

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

پارامترها
fileId

string

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

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

پارامترها
pageSize

integer

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

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

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

pageToken

string

توکن برای ادامه درخواست لیست قبلی در صفحه بعد. این باید روی مقدار nextPageToken از پاسخ قبلی تنظیم شود.

supportsAllDrives

boolean

اینکه آیا برنامه درخواست‌کننده از هر دو درایوهای من و درایوهای اشتراکی پشتیبانی می‌کند یا خیر.

supportsTeamDrives
(deprecated)

boolean

منسوخ شده: به جای آن supportsAllDrives استفاده کنید.

useDomainAdminAccess

boolean

درخواست را به عنوان مدیر دامنه ارسال کنید.

اگر روی true تنظیم شود، و اگر شرایط اضافی زیر برقرار باشند، به درخواست‌کننده دسترسی داده می‌شود:

  1. پارامتر شناسه فایل به یک درایو مشترک اشاره دارد.
  2. درخواست‌کننده، مدیر دامنه‌ای است که درایو اشتراکی به آن تعلق دارد.

برای اطلاعات بیشتر، به مدیریت درایوهای مشترک به عنوان مدیر دامنه مراجعه کنید.

includePermissionsForView

string

مشخص می‌کند که کدام مجوزهای نمای اضافی باید در پاسخ لحاظ شوند. فقط published پشتیبانی می‌شود.

درخواست بدنه

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

بدنه پاسخ

فهرستی از مجوزهای دسترسی به یک فایل.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
فیلدها
permissions[]

object ( Permission )

فهرست مجوزها. اگر nextPageToken پر شده باشد، ممکن است این فهرست ناقص باشد و باید یک صفحه اضافی از نتایج واکشی شود.

nextPageToken

string

نشانه صفحه برای صفحه بعدی مجوزها. اگر به انتهای لیست مجوزها رسیده باشید، این فیلد وجود نخواهد داشت. اگر نشانه به هر دلیلی رد شود، باید کنار گذاشته شود و صفحه‌بندی باید از صفحه اول نتایج مجدداً آغاز شود. نشانه صفحه معمولاً برای چند ساعت معتبر است. با این حال، اگر موارد جدیدی اضافه یا حذف شوند، نتایج مورد انتظار شما ممکن است متفاوت باشد.

kind

string

نوع منبع را مشخص می‌کند. مقدار: رشته‌ی ثابت "drive#permissionList" .

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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