Method: permissions.list

يسرد أذونات ملف أو مساحة تخزين سحابي مشتركة.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
fileId

string

رقم تعريف الملف أو مساحة التخزين السحابي المشتركة

معلمات طلب البحث

المَعلمات
pageSize

integer

الحد الأقصى لعدد الأذونات المطلوب عرضها لكل صفحة. في حال عدم ضبط السياسة لملفات في مساحة تخزين سحابي مشتركة، سيتم عرض 100 نتيجة كحدّ أقصى. وفي حال عدم ضبط هذه السياسة لملفات غير متوفّرة في مساحة تخزين سحابي مشتركة، سيتم عرض القائمة بأكملها.

pageToken

string

الرمز المميّز لمتابعة طلب قائمة سابق في الصفحة التالية يجب ضبط هذه القيمة على قيمة "nextPageToken" من الاستجابة السابقة.

supportsAllDrives

boolean

ما إذا كان التطبيق الذي يقدّم الطلب متوافقًا مع كل من "ملفاتي" ومساحات التخزين السحابي المشتركة.

supportsTeamDrives
(deprecated)

boolean

متوقّفة نهائيًا: يمكنك استخدام supportsAllDrives بدلاً منها.

useDomainAdminAccess

boolean

أصدر الطلب كمشرف نطاق. في حال ضبط هذه السياسة على "صحيح"، سيتم منح مقدِّم الطلب إذن الوصول إذا كانت مَعلمة رقم تعريف الملف تشير إلى مساحة تخزين سحابي مشترَكة، وكان مقدِّم الطلب مشرفًا على النطاق الذي تنتمي إليه مساحة التخزين السحابي المشتركة.

includePermissionsForView

string

تحدد أذونات الملف الشخصي الإضافية التي يتم تضمينها في الرد. يمكن استخدام الحالة "المنشورة" فقط.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

قائمة الأذونات لملف.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "nextPageToken": string,
  "kind": string,
  "permissions": [
    {
      object (Permission)
    }
  ]
}
الحقول
nextPageToken

string

الرمز المميز للصفحة للصفحة التالية من الأذونات سيكون هذا الحقل غير متاح في حال الوصول إلى نهاية قائمة الأذونات. وإذا تم رفض الرمز المميز لأي سبب من الأسباب، يجب تجاهله وإعادة تشغيل التقسيم على صفحات من الصفحة الأولى من النتائج. يكون الرمز المميز للصفحة عادةً صالحًا لعدة ساعات. ومع ذلك، قد تختلف النتائج المتوقّعة في حال إضافة عناصر جديدة أو إزالتها.

kind

string

تحدد نوع هذا المورد. القيمة: السلسلة الثابتة "drive#permissionList".

permissions[]

object (Permission)

قائمة الأذونات في حال تعبئة NextPageToken، قد تكون هذه القائمة غير مكتملة وسيتم جلب صفحة إضافية من النتائج.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.