Method: permissions.list

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المَعلمات
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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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