Method: approvals.list

تعرِض هذه الطريقة الموافقات على ملف. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة الموافقات.

تعرِض هذه الطريقة بشكلٍ تلقائي استجابة بسيطة قد لا تتضمّن مصفوفة items. لاسترداد تفاصيل الموافقة، عليك تحديد الحقول التي تريدها بشكلٍ صريح باستخدام مَعلمة طلب البحث fields. لعرض الحقول التي تحتاج إليها تحديدًا، يُرجى الاطّلاع على عرض حقول معيّنة.

طلب 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

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