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

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