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

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