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)
}
} |
| الحقول |
exportLinks |
map (key: string, value: string)
النتائج فقط. روابط لتصدير ملفات "أدوات تحرير المستندات" إلى تنسيقات معيّنة عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
|
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".
|
publishedLink |
string
النتائج فقط. رابط يؤدي إلى المراجعة المنشورة لا تتم تعبئة هذا الحقل إلا لملفات "مجموعة محرّري مستندات Google".
|
size |
string (int64 format)
النتائج فقط. حجم محتوى المراجعة بالبايت لا ينطبق هذا الخيار إلا على الملفات ذات المحتوى الثنائي في Drive.
|
originalFilename |
string
النتائج فقط. اسم الملف الأصلي المستخدَم لإنشاء هذه المراجعة. لا ينطبق هذا الخيار إلا على الملفات ذات المحتوى الثنائي في Drive.
|
lastModifyingUser |
object (User)
النتائج فقط. المستخدم الذي عدّل هذه النسخة آخر مرة لا تتم تعبئة هذا الحقل إلا عندما يجري مستخدم مسجّل الدخول آخر تعديل.
|
الطُرق |
|
|
لحذف إصدار ملف نهائيًا |
|
|
تعرض هذه الطريقة البيانات الوصفية أو المحتوى الخاصين بمراجعة معيّنة حسب رقم التعريف. |
|
|
تعرض هذه الطريقة نُسخًا سابقة من ملف. |
|
|
تعدّل هذه الطريقة مراجعة باستخدام دلالات التصحيح. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# REST Resource: revisions\n\n- [Resource: Revision](#Revision)\n - [JSON representation](#Revision.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Revision\n------------------\n\nThe metadata for a revision to a file.\n\nSome resource methods (such as `revisions.update`) require a `revisionId`. Use the `revisions.list` method to retrieve the ID for a revision.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"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 (/workspace/drive/api/reference/rest/v3/User) } } ``` |\n\n| Fields ||\n|--------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `exportLinks` | `map (key: string, value: string)` Output only. Links for exporting Docs Editors files to specific formats. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n| `id` | `string` Output only. The ID of the revision. |\n| `mimeType` | `string` Output only. The MIME type of the revision. |\n| `kind` | `string` Output only. Identifies what kind of resource this is. Value: the fixed string `\"drive#revision\"`. |\n| `published` | `boolean` Whether this revision is published. This is only applicable to Docs Editors files. |\n| `keepForever` | `boolean` Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file. This field is only applicable to files with binary content in Drive. |\n| `md5Checksum` | `string` Output only. The MD5 checksum of the revision's content. This is only applicable to files with binary content in Drive. |\n| `modifiedTime` | `string` Output only. The last time the revision was modified (RFC 3339 date-time). |\n| `publishAuto` | `boolean` Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files. |\n| `publishedOutsideDomain` | `boolean` Whether this revision is published outside the domain. This is only applicable to Docs Editors files. |\n| `publishedLink` | `string` Output only. A link to the published revision. This is only populated for Docs Editors files. |\n| `size` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The size of the revision's content in bytes. This is only applicable to files with binary content in Drive. |\n| `originalFilename` | `string` Output only. The original filename used to create this revision. This is only applicable to files with binary content in Drive. |\n| `lastModifyingUser` | `object (`[User](/workspace/drive/api/reference/rest/v3/User)`)` Output only. The last user to modify this revision. This field is only populated when the last modification was performed by a signed-in user. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------------|----------------------------------------------|\n| ### [delete](/workspace/drive/api/reference/rest/v3/revisions/delete) | Permanently deletes a file version. |\n| ### [get](/workspace/drive/api/reference/rest/v3/revisions/get) | Gets a revision's metadata or content by ID. |\n| ### [list](/workspace/drive/api/reference/rest/v3/revisions/list) | Lists a file's revisions. |\n| ### [update](/workspace/drive/api/reference/rest/v3/revisions/update) | Updates a revision with patch semantics. |"]]
