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)
פלט בלבד. קישורים לייצוא קבצים בכלי העריכה של Docs לפורמטים ספציפיים. אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }
|
id |
string
פלט בלבד. המזהה של הגרסה.
|
mimeType |
string
פלט בלבד. סוג ה-MIME של הגרסה.
|
kind |
string
פלט בלבד. מזהה את סוג המשאב. הערך: המחרוזת הקבועה "drive#revision".
|
published |
boolean
האם הגרסה הזו פורסמה. האפשרות הזו רלוונטית רק לקבצים של כלי העריכה של Docs.
|
keepForever |
boolean
האם לשמור את הגרסה הזו לנצח, גם אם היא כבר לא הגרסה העדכנית. אם לא תוגדר, הגרסה תוסר אוטומטית 30 ימים אחרי העלאת תוכן חדש יותר. אפשר להגדיר את זה ל-200 גרסאות לכל היותר של קובץ. השדה הזה רלוונטי רק לקבצים עם תוכן בינארי ב-Drive.
|
md5Checksum |
string
פלט בלבד. סכום הבדיקה MD5 של תוכן השינוי. האפשרות הזו רלוונטית רק לקבצים עם תוכן בינארי ב-Drive.
|
modifiedTime |
string
פלט בלבד. הפעם האחרונה שבה בוצע שינוי בגרסה (תאריך ושעה בפורמט RFC 3339).
|
publishAuto |
boolean
האם גרסאות מתוקנות עוקבות יפורסמו מחדש באופן אוטומטי. האפשרות הזו רלוונטית רק לקבצים של כלי העריכה של Docs.
|
publishedOutsideDomain |
boolean
האם הגרסה הזו פורסמה מחוץ לדומיין. האפשרות הזו רלוונטית רק לקבצים של כלי העריכה של Docs.
|
publishedLink |
string
פלט בלבד. קישור לגרסה שפורסמה. השדה הזה מאוכלס רק בקבצים של מוצרי Google Docs.
|
size |
string (int64 format)
פלט בלבד. גודל התוכן של השינוי בבייטים. האפשרות הזו רלוונטית רק לקבצים עם תוכן בינארי ב-Drive.
|
originalFilename |
string
פלט בלבד. שם הקובץ המקורי ששימש ליצירת הגרסה הזו. האפשרות הזו רלוונטית רק לקבצים עם תוכן בינארי ב-Drive.
|
lastModifyingUser |
object (User)
פלט בלבד. המשתמש האחרון שערך את הגרסה הזו. השדה הזה מאוכלס רק אם השינוי האחרון בוצע על ידי משתמש מחובר.
|
Methods |
|
|
מחיקה סופית של גרסת קובץ. |
|
|
אחזור מטא-נתונים או תוכן של תיקון לפי מזהה. |
|
|
מציג את הגרסאות הקודמות של קובץ. |
|
|
מעדכן את הגרסה באמצעות סמנטיקה של תיקון. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],[],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. |"]]
