Method: revisions.list

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

ملاحظة مهمة: قد تكون قائمة المراجعات التي تعرضها هذه الطريقة غير مكتملة للملفات التي تتضمّن سجلّ مراجعات كبيرًا، بما في ذلك "مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google" التي يتم تعديلها بشكل متكرّر. قد يتم حذف النُسخ السابقة من الردّ، ما يعني أنّ النسخة الأولى التي يتم عرضها قد لا تكون أقدم نسخة حالية. قد يكون سجلّ المراجعات الظاهر في واجهة مستخدم محرّر Workspace أكثر اكتمالاً من القائمة التي تعرضها واجهة برمجة التطبيقات.

طلب HTTP

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

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

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

المعلمات
fileId

string

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

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

المعلمات
pageSize

integer

الحدّ الأقصى لعدد المراجعات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة.

إذا لم يتم تحديدها، سيتم عرض 200 مراجعة كحد أقصى.

الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأعلى من 1000.
pageToken

string

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

نص الطلب

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

نص الاستجابة

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

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

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

object (Revision)

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

string

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

string

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

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

يجب توفير أحد نطاقات 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

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