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

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