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 
{
  "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

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