Method: revisions.list

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المَعلمات
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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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