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.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

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