REST Resource: revisions

المورد: Revision

البيانات الوصفية لنسخة سابقة من ملف

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

تمثيل JSON 
{
  "exportLinks": {
    string: string,
    ...
  },
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "keepForever": boolean,
  "md5Checksum": string,
  "modifiedTime": string,
  "publishAuto": boolean,
  "publishedOutsideDomain": boolean,
  "publishedLink": string,
  "size": string,
  "originalFilename": string,
  "lastModifyingUser": {
    object (User)
  }
}
الحقول
id

string

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

string

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

string

النتائج فقط. تحدّد نوع المورد. القيمة: السلسلة الثابتة "drive#revision".
published

boolean

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

boolean

تحديد ما إذا كان سيتم الاحتفاظ بهذه المراجعة إلى الأبد، حتى إذا لم تعُد المراجعة الرئيسية إذا لم يتم ضبطها، سيتم حذف المراجعة تلقائيًا بعد 30 يومًا من تحميل محتوى أحدث. يمكن ضبط ذلك على 200 مراجعة كحدّ أقصى لملف.

لا ينطبق هذا الحقل إلا على الملفات ذات المحتوى الثنائي في Drive.
md5Checksum

string

النتائج فقط. المجموع الاختباري MD5 لمحتوى المراجعة. لا ينطبق هذا الخيار إلا على الملفات ذات المحتوى الثنائي في Drive.
modifiedTime

string

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

boolean

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

boolean

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

string (int64 format)

النتائج فقط. حجم محتوى المراجعة بالبايت لا ينطبق هذا الخيار إلا على الملفات ذات المحتوى الثنائي في Drive.
originalFilename

string

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

object (User)

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

الطُرق

delete

 لحذف إصدار ملف نهائيًا

get

 تعرض هذه الطريقة البيانات الوصفية أو المحتوى الخاصين بمراجعة معيّنة حسب رقم التعريف.

list

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

update

 تعدّل هذه الطريقة مراجعة باستخدام دلالات التصحيح.