يسرد أذونات ملف أو مساحة تخزين سحابي مشتركة.
طلب HTTP
GET https://www.googleapis.com/drive/v2/files/{fileId}/permissions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
fileId |
رقم تعريف الملف أو مساحة التخزين السحابي المشتركة |
معلمات طلب البحث
المَعلمات | |
---|---|
maxResults |
الحد الأقصى لعدد الأذونات المطلوب عرضها لكل صفحة. في حال عدم ضبط السياسة لملفات في مساحة تخزين سحابي مشتركة، سيتم عرض 100 نتيجة كحدّ أقصى. وفي حال عدم ضبط هذه السياسة لملفات غير متوفّرة في مساحة تخزين سحابي مشتركة، سيتم عرض القائمة بأكملها. |
pageToken |
الرمز المميّز لمتابعة طلب قائمة سابق في الصفحة التالية ويجب ضبط هذه السياسة على قيمة |
supportsAllDrives |
ما إذا كان التطبيق الذي يقدّم الطلب متوافقًا مع كل من "ملفاتي" ومساحات التخزين السحابي المشتركة. |
supportsTeamDrives |
متوقّفة نهائيًا: يمكنك استخدام |
useDomainAdminAccess |
أصدر الطلب كمشرف نطاق. في حال ضبط هذه السياسة على "صحيح"، سيتم منح مقدِّم الطلب إذن الوصول إذا كانت مَعلمة رقم تعريف الملف تشير إلى مساحة تخزين سحابي مشترَكة، وكان مقدِّم الطلب مشرفًا على النطاق الذي تنتمي إليه مساحة التخزين السحابي المشتركة. |
includePermissionsForView |
تحدد أذونات الملف الشخصي الإضافية التي يتم تضمينها في الرد. يُسمح فقط بالقيمة |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة بالأذونات المرتبطة بملف
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"items": [
{
object ( |
الحقول | |
---|---|
nextPageToken |
الرمز المميز للصفحة للصفحة التالية من الأذونات سيكون هذا الحقل غير متاح في حال الوصول إلى نهاية قائمة الأذونات. وإذا تم رفض الرمز المميز لأي سبب من الأسباب، يجب تجاهله وإعادة تشغيل التقسيم على صفحات من الصفحة الأولى من النتائج. |
kind |
دائمًا ما تكون |
etag |
علامة ETag للقائمة. |
selfLink |
رابط للرجوع إلى هذه القائمة. |
items[] |
قائمة الأذونات |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/docs
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
تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.