Method: permissions.list

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

درخواست HTTP

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

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

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

پارامترها
fileId

string

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

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

پارامترها
maxResults

integer

حداکثر تعداد مجوز برای بازگشت در هر صفحه. وقتی برای فایل‌های درایو مشترک تنظیم نشده باشد، حداکثر 100 نتیجه برگردانده می‌شود. وقتی برای فایل‌هایی که در درایو مشترک نیستند تنظیم نشده باشد، کل لیست برگردانده می‌شود.

pageToken

string

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

useDomainAdminAccess

boolean

درخواست را به عنوان مدیر دامنه صادر کنید. اگر روی true تنظیم شود، اگر پارامتر ID فایل به یک درایو مشترک اشاره کند و درخواست کننده مدیر دامنه ای باشد که درایو مشترک به آن تعلق دارد، به درخواست کننده اجازه دسترسی داده می شود.

includePermissionsForView

string

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

درخواست بدن

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

بدن پاسخگو

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

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

نمایندگی JSON 
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "items": [
    {
      object (Permission)
    }
  ]
}
فیلدها
nextPageToken

string

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

kind

string

این همیشه drive#permissionList است.

etag

string

ETag لیست.

items[]

object ( Permission )

لیست مجوزها

محدوده مجوز

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

  • https://www.googleapis.com/auth/docs
  • 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

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