Method: approvals.list

تعرض هذه السمة الموافقات على ملف.

طلب HTTP

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

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

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

المعلمات
fileId

string

الحقل مطلوب. معرّف الملف الذي يتضمّن الموافقة

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

المعلمات
pageSize

integer

الحدّ الأقصى لعدد الموافقات التي سيتم عرضها في حال عدم ضبطها، سيتم عرض 100 موافقة كحدّ أقصى.
pageToken

string

الرمز المميز لمواصلة طلب قائمة سابق في الصفحة التالية يجب ضبط هذه السمة على قيمة nextPageToken من استجابة سابقة.

نص الطلب

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

نص الاستجابة

ردّ طلب قائمة الموافقات.

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

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

string

هذه السمة هي دائمًا drive#approvalList
items[]

object (Approval)

قائمة الموافقات إذا تم ملء nextPageToken، قد تكون هذه القائمة غير مكتملة ويجب استرداد صفحة إضافية من النتائج.
nextPageToken

string

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

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • 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

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