Method: permissions.list

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

درخواست HTTP

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

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

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

پارامترها
fileId

string

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

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

پارامترها
pageSize

integer

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

pageToken

string

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

supportsAllDrives

boolean

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

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

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