REST Resource: revisions

المورد: النسخة المنقَّحة

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

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

تمثيل JSON
{
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "exportLinks": {
    string: string,
    ...
  },
  "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

تعديل مراجعة باستخدام دلالات التصحيح