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

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

keepForever

boolean

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

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

md5Checksum

string

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

modifiedTime

string

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

publishAuto

boolean

ما إذا كان سيتم إعادة نشر النُسخ اللاحقة تلقائيًا أم لا. لا ينطبق ذلك إلا على ملفات "أدوات تحرير المستندات".

publishedOutsideDomain

boolean

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

size

string (int64 format)

النتائج فقط. حجم محتوى النسخة السابقة بالبايت. ينطبق ذلك فقط على الملفات التي تحتوي على محتوى ثنائي في Drive.

originalFilename

string

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

lastModifyingUser

object (User)

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

الطُرق

delete

يحذف نسخة من الملف نهائيًا.

get

يتيح هذا الإعداد الحصول على البيانات الوصفية أو المحتوى لنسخة سابقة حسب رقم التعريف.

list

سرد مراجعات ملف

update

لتعديل النسخة السابقة باستخدام دلالات رمز التصحيح