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 والإصدار 3 التجريبي.
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

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