REST Resource: revisions

المرجع: مراجعة

البيانات الوصفية لنسخة سابقة من ملف.

تتطلّب بعض طُرق الموارد (مثل revisions.update) السمة revisionId. استخدِم الطريقة revisions.list لاسترداد المعرّف لإحدى النُسخ السابقة.

تمثيل JSON
{
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "exportLinks": {
    string: string,
    ...
  },
  "keepForever": boolean,
  "md5Checksum": string,
  "modifiedTime": string,
  "publishAuto": boolean,
  "publishedOutsideDomain": boolean,
  "publishedLink": string,
  "size": string,
  "originalFilename": string,
  "lastModifyingUser": {
    object (User)
  }
}
الحقول
id

string

النتائج فقط. رقم تعريف النسخة السابقة.

mimeType

string

النتائج فقط. تمثّل هذه السمة نوع MIME للنسخة السابقة.

kind

string

النتائج فقط. تحدد نوع هذا المورد. القيمة: السلسلة الثابتة "drive#revision".

published

boolean

لتحديد ما إذا تم نشر هذه النسخة السابقة أم لا. لا ينطبق ذلك إلا على ملفات "أدوات تحرير المستندات".

keepForever

boolean

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

لا ينطبق هذا الحقل إلا على الملفات التي تتضمّن محتوى ثنائيًا في Drive.

md5Checksum

string

النتائج فقط. المجموع الاختباري MD5 لمحتوى النسخة السابقة. لا ينطبق هذا إلا على الملفات التي تتضمن محتوى ثنائيًا في Drive.

modifiedTime

string

النتائج فقط. تاريخ آخر تعديل تم فيه تعديل النسخة السابقة (التاريخ-الوقت RFC 3339).

publishAuto

boolean

ما إذا كان سيتم إعادة نشر النُسخ اللاحقة تلقائيًا أم لا. لا ينطبق ذلك إلا على ملفات "أدوات تحرير المستندات".

publishedOutsideDomain

boolean

ما إذا تم نشر هذه النسخة السابقة خارج النطاق. لا ينطبق ذلك إلا على ملفات "أدوات تحرير المستندات".

size

string (int64 format)

النتائج فقط. حجم محتوى النسخة السابقة بالبايت. لا ينطبق هذا إلا على الملفات التي تتضمن محتوى ثنائيًا في Drive.

originalFilename

string

النتائج فقط. اسم الملف الأصلي المُستخدَم لإنشاء هذه النسخة السابقة. لا ينطبق هذا إلا على الملفات التي تتضمن محتوى ثنائيًا في Drive.

lastModifyingUser

object (User)

النتائج فقط. المستخدم الأخير الذي عدّل هذه النسخة.

الطُرق

delete

يحذف نسخة من الملف نهائيًا.

get

الحصول على البيانات الوصفية أو المحتوى الخاص بالنسخة السابقة حسب رقم التعريف

list

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

update

يحدّث النسخة السابقة باستخدام دلالات التصحيح.