Method: permissions.list

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

طلب HTTP

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

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

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

المعلمات
fileId

string

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

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

المعلمات
pageSize

integer

الحد الأقصى لعدد الأذونات التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة.

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

الحد الأقصى للقيمة هو 100، وسيتم فرض القيمة 100 على القيم التي تزيد عن 100.
pageToken

string

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

boolean

تُستخدَم لتحديد ما إذا كان التطبيق الذي يطلب الوصول يتيح استخدام كل من "ملفاتي" ومساحات التخزين السحابي المشتركة.
supportsTeamDrives
(deprecated)

boolean

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة supportsAllDrives بدلاً منها.
useDomainAdminAccess

boolean

أرسِل الطلب بصفتك مشرف نطاق.

إذا تم ضبطها على true، وفي حال استيفاء الشروط الإضافية التالية، يتم منح مقدّم الطلب إذن الوصول:

  1. تشير مَعلمة معرّف الملف إلى مساحة تخزين سحابي مشتركة.
  2. مقدّم الطلب هو مشرف النطاق الذي تنتمي إليه مساحة التخزين السحابي المشتركة.

لمزيد من المعلومات، يُرجى الاطّلاع على إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق.
includePermissionsForView

string

تحدّد هذه السمة أذونات العرض الإضافية المطلوب تضمينها في الردّ. يُسمح فقط بالقيمة published.

نص الطلب

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

نص الاستجابة

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

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

تمثيل 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

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