Method: files.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)

قائمة اقتراحات الوصول تتم تعبئة هذا الحقل في الإصدارَين v3 وv3beta فقط.
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

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

AccessProposal

مرجع "اقتراح الوصول" لطلبات الوصول غير المُعتمَدة في ملف

تمثيل JSON 
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
الحقول
fileId

string

معرّف الملف الذي تم تفعيل اقتراح الوصول إليه
proposalId

string

معرّف اقتراح الوصول
requesterEmailAddress

string

عنوان البريد الإلكتروني للمستخدم الذي يطلب الإجراء
recipientEmailAddress

string

عنوان البريد الإلكتروني للمستخدم الذي سيحصل على الأذونات في حال القبول
rolesAndViews[]

object (RoleAndView)

عنصر تغليف للدور وعرض اقتراح الوصول
requestMessage

string

الرسالة التي أضافها مقدِّم الطلب إلى الاقتراح
createTime

string (Timestamp format)

وقت الإنشاء

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

RoleAndView

عنصر تغليف للدور وعرض اقتراح الوصول

تمثيل JSON 
{
  "role": string,
  "view": string
}
الحقول
role

string

يمكن إضافة القيم الجديدة التي اقترحها مقدِّم الطلب في المستقبل، غير أنّ الاحتمالات التالية ممكنة حاليًا: * writer * commenter * reader
view

string

يشير إلى طريقة العرض لهذا الاقتراح بالوصول. تتم تعبئة هذا الحقل فقط للاقتراحات التي تنتمي إلى طريقة العرض. published هي القيمة الوحيدة المسموح بها.