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

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