REST Resource: revisions

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

نسخة سابقة من ملف.

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

تمثيل JSON
{
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "etag": string,
  "exportLinks": {
    string: string,
    ...
  },
  "pinned": boolean,
  "md5Checksum": string,
  "modifiedDate": string,
  "lastModifyingUserName": string,
  "downloadUrl": string,
  "publishAuto": boolean,
  "publishedOutsideDomain": boolean,
  "publishedLink": string,
  "fileSize": string,
  "originalFilename": string,
  "lastModifyingUser": {
    object (User)
  },
  "selfLink": string
}
الحقول
id

string

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

mimeType

string

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

kind

string

النتائج فقط. دائمًا ما تكون drive#revision.

published

boolean

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

etag

string

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

pinned

boolean

ما إذا كان سيتم تثبيت هذه النسخة السابقة لمنع الإزالة التلقائية وفي حال عدم ضبط هذه السياسة، تتم تلقائيًا إزالة النسخة السابقة نهائيًا بعد 30 يومًا من تحميل محتوى جديد. لا يمكن تعديل هذا الحقل إلا على الملفات التي تحتوي على محتوى مخزَّن في Drive، باستثناء ملفات "أدوات تحرير المستندات". يمكن أيضًا تثبيت النُسخ السابقة عند إنشائها من خلال drive.files.insert/update/copy باستخدام مَعلمة طلب البحث المثبّتة. يتم تخزين النُسخ السابقة المثبّتة إلى أجل غير مسمى باستخدام حصة مساحة تخزين إضافية تصل إلى 200 نسخة سابقة كحدّ أقصى.

md5Checksum

string

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

modifiedDate

string

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

lastModifyingUserName

string

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

downloadUrl

string

النتائج فقط. عنوان URL قصير المدى لتنزيل الملف. لن تتم تعبئة هذا الحقل إلا في الملفات التي تتضمّن محتوى مخزَّنًا في Drive.

publishAuto

boolean

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

publishedOutsideDomain

boolean

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

fileSize

string (int64 format)

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

originalFilename

string

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

lastModifyingUser

object (User)

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

الطُرق

delete

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

get

الحصول على مراجعة محدّدة

list

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

patch

لتعديل نسخة سابقة

update

لتعديل نسخة سابقة