Method: permissions.list

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

طلب HTTP

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

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

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

المعلمات
fileId

string

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

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

المعلمات
maxResults

integer

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

pageToken

string

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

useDomainAdminAccess

boolean

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

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

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