Method: revisions.list

سرد مراجعات ملف

طلب HTTP

GET https://www.googleapis.com/drive/v2/files/{fileId}/revisions

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

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

المعلمات
fileId

string

رقم تعريف الملف.

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

المعلمات
maxResults

integer

الحد الأقصى لعدد المراجعات المطلوب عرضها.

pageToken

string

الرمز المميز للصفحة للنُسخ السابقة. للحصول على صفحة النتائج التالية، عيِّن هذه المعلمة على القيمة "nextPageToken" من الرد السابق.

نص الطلب

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

نص الاستجابة

قائمة بالنُسخ السابقة من ملف.

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

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

string

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

kind

string

دائمًا ما تكون هذه هي drive#revisionList.

etag

string

تمثّل هذه السمة علامة ETag الخاصة بالقائمة.

items[]

object (Revision)

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

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

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/docs
  • 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.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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