Method: accessproposals.list

عرض قائمة باقتراحات الوصول إلى ملف لمزيد من المعلومات، يُرجى الاطّلاع على إدارة اقتراحات الوصول المعلقة.

ملاحظة: يمكن للمستخدمين مانِحي الموافقة فقط إدراج اقتراحات الوصول إلى ملف. إذا لم يكن المستخدم من الموافقين، سيتم عرض الخطأ 403.

طلب HTTP

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

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

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

المعلمات
fileId

string

مطلوب. معرّف العنصر الذي تم إرسال الطلب بشأنه.

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

المعلمات
pageToken

string

اختياريّ. رمز مواصلة في قائمة طلبات الوصول
pageSize

integer

اختياريّ. عدد النتائج في كل صفحة

نص الطلب

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

نص الاستجابة

الردّ على طلب قائمة اقتراحات الوصول

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

تمثيل JSON 
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
الحقول
accessProposals[]

object (AccessProposal)

قائمة اقتراحات الوصول لا تتم تعبئة هذا الحقل إلا في الإصدار 3 من Drive API.
nextPageToken

string

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

نطاقات التفويض

يجب توفير أحد نطاقات 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.readonly

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