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

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

etag

string

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

pinned

boolean

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

md5Checksum

string

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

modifiedDate

string

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

lastModifyingUserName

string

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

downloadUrl

string

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

publishAuto

boolean

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

publishedOutsideDomain

boolean

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

fileSize

string (int64 format)

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

originalFilename

string

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

lastModifyingUser

object (User)

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

الطُرق

delete

يؤدي هذا الإجراء إلى حذف إصدار ملف نهائيًا.

get

الحصول على نسخة مراجعة معيّنة

list

يعرض هذا الخيار النُسخ السابقة من ملف.

patch

تعديلات على مراجعة

update

تعديلات على مراجعة