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

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