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

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