REST Resource: revisions

المورد: Revision

تمثّل هذه السمة نسخة معدَّلة من ملف.

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

تمثيل JSON 
{
  "exportLinks": {
    string: string,
    ...
  },
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "etag": 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 باستخدام مَعلمة طلب البحث pinned. يتم تخزين المراجعات المثبّتة إلى أجل غير مسمى باستخدام حصة تخزين إضافية، وبحد أقصى 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

 تعديل مراجعة