المرجع: مراجعة
نسخة سابقة من ملف.
تتطلّب بعض طُرق الموارد (مثل 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 ( |
الحقول | |
---|---|
id |
النتائج فقط. رقم تعريف النسخة السابقة. |
mimeType |
النتائج فقط. تمثّل هذه السمة نوع MIME للنسخة السابقة. |
kind |
النتائج فقط. دائمًا ما تكون |
published |
لتحديد ما إذا تم نشر هذه النسخة السابقة أم لا. تتم تعبئة هذا الحقل فقط ولا يمكن تعديله إلا لملفات "أدوات تحرير المستندات". |
etag |
النتائج فقط. علامة ETag الخاصة بالمراجعة |
exportLinks |
النتائج فقط. روابط لتصدير ملفات "أدوات تحرير المستندات" إلى تنسيقات محدَّدة عنصر يحتوي على قائمة من أزواج |
pinned |
ما إذا كان سيتم تثبيت هذه النسخة السابقة لمنع الإزالة التلقائية وفي حال عدم ضبط هذه السياسة، تتم تلقائيًا إزالة النسخة السابقة نهائيًا بعد 30 يومًا من تحميل محتوى جديد. لا يمكن تعديل هذا الحقل إلا على الملفات التي تحتوي على محتوى مخزَّن في Drive، باستثناء ملفات "أدوات تحرير المستندات". يمكن أيضًا تثبيت النُسخ السابقة عند إنشائها من خلال drive.files.insert/update/copy باستخدام مَعلمة طلب البحث المثبّتة. يتم تخزين النُسخ السابقة المثبّتة إلى أجل غير مسمى باستخدام حصة مساحة تخزين إضافية تصل إلى 200 نسخة سابقة كحدّ أقصى. |
md5Checksum |
النتائج فقط. مجموع اختباري MD5 لمحتوى هذه النسخة السابقة. لن تتم تعبئة هذا الحقل إلا في الملفات التي تتضمّن محتوى مخزَّنًا في Drive. |
modifiedDate |
النتائج فقط. آخر مرة تم فيها تعديل هذه النسخة السابقة (الطابع الزمني بتنسيق RFC 3339). |
lastModifyingUserName |
النتائج فقط. اسم المستخدم الأخير الذي عدّل هذه النسخة السابقة. |
downloadUrl |
النتائج فقط. عنوان URL قصير المدى لتنزيل الملف. لن تتم تعبئة هذا الحقل إلا في الملفات التي تتضمّن محتوى مخزَّنًا في Drive. |
publishAuto |
ما إذا كان سيتم إعادة نشر النُسخ اللاحقة تلقائيًا أم لا. تتم تعبئة هذا الحقل فقط ولا يمكن تعديله إلا لملفات "أدوات تحرير المستندات". |
publishedOutsideDomain |
ما إذا تم نشر هذه النسخة السابقة خارج النطاق. تتم تعبئة هذا الحقل فقط ولا يمكن تعديله إلا لملفات "أدوات تحرير المستندات". |
publishedLink |
النتائج فقط. رابط إلى النسخة المنشورة. وتتم تعبئة هذه المعلومات فقط لملفات "مواقع Google". |
fileSize |
النتائج فقط. حجم النسخة السابقة بالبايت. لن تتم تعبئة هذا الحقل إلا في الملفات التي تتضمّن محتوى مخزَّنًا في Drive. |
originalFilename |
النتائج فقط. اسم الملف الأصلي عند إنشاء هذه النسخة السابقة. لن تتم تعبئة هذا الحقل إلا في الملفات التي تتضمّن محتوى مخزَّنًا في Drive. |
lastModifyingUser |
النتائج فقط. المستخدم الأخير الذي عدّل هذه النسخة. |
selfLink |
النتائج فقط. رابط للرجوع إلى هذه النسخة السابقة. |
الطُرق |
|
---|---|
|
يحذف نسخة من الملف نهائيًا. |
|
الحصول على مراجعة محدّدة |
|
يسرد النُسخ السابقة من ملف. |
|
لتعديل نسخة سابقة |
|
لتعديل نسخة سابقة |