Method: revisions.list

يسرد النُسخ السابقة من ملف.

طلب HTTP

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

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

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

المعلمات
fileId

string

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

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

المعلمات
pageSize

integer

الحد الأقصى لعدد النُسخ السابقة التي سيتم عرضها في كل صفحة
pageToken

string

الرمز المميّز لمواصلة طلب قائمة سابق في الصفحة التالية يجب ضبط هذه القيمة على قيمة nextPageToken من الاستجابة السابقة.

نص الطلب

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

نص الاستجابة

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

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

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

string

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

string

لتحديد نوع المورد. القيمة: السلسلة الثابتة "drive#revisionList".
revisions[]

object (Revision)

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

نطاقات التفويض

يتطلب أحد نطاقات 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.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

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