REST Resource: revisions

משאב: גרסה קודמת

גרסה של קובץ.

לשיטות משאבים מסוימות (כמו revisions.update) נדרש revisionId. כדי לאחזר את המזהה לגרסה קודמת, יש להשתמש בשיטה revisions.list.

ייצוג JSON
{
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "etag": string,
  "exportLinks": {
    string: string,
    ...
  },
  "pinned": boolean,
  "md5Checksum": string,
  "modifiedDate": string,
  "lastModifyingUserName": string,
  "downloadUrl": string,
  "publishAuto": boolean,
  "publishedOutsideDomain": boolean,
  "publishedLink": string,
  "fileSize": string,
  "originalFilename": string,
  "lastModifyingUser": {
    object (User)
  },
  "selfLink": string
}
שדות
id

string

פלט בלבד. מזהה הגרסה הקודמת.

mimeType

string

פלט בלבד. סוג MIME של הגרסה הקודמת.

kind

string

פלט בלבד. הערך הוא תמיד drive#revision.

published

boolean

האם גרסה זו פורסמה. השדה הזה מאוכלס רק ואפשר לשנות אותו רק בקבצים של עורכי Docs.

etag

string

פלט בלבד. ה-ETag של הגרסה הקודמת.

pinned

boolean

אם הגרסה הזו מוצמדת כדי למנוע מחיקה אוטומטית לצמיתות. אם לא מגדירים אותה, הגרסה נמחקת באופן אוטומטי 30 ימים אחרי שמעלים תוכן חדש יותר. ניתן לשנות את השדה הזה רק בקבצים עם תוכן שמאוחסן ב-Drive, לא כולל קבצים של עורכי Docs. אפשר להצמיד גרסאות קודמות גם כשהן נוצרות דרך drive.files.insert/update/copy באמצעות פרמטר השאילתה המוצמד. גרסאות קודמות מוצמדות נשמרות ללא הגבלת זמן תוך שימוש במכסת אחסון נוספת, עד 200 גרסאות קודמות לכל היותר.

md5Checksum

string

פלט בלבד. בדיקת סיכום של MD5 לתוכן של הגרסה הזו. השדה הזה יאוכלס רק בקבצים שמכילים תוכן שמאוחסן ב-Drive.

modifiedDate

string

פלט בלבד. הפעם האחרונה שבה הגרסה הזו שונתה (בפורמט RFC 3339).

lastModifyingUserName

string

פלט בלבד. שם המשתמש האחרון ששינית את הגרסה הזו.

downloadUrl

string

פלט בלבד. כתובת URL להורדת הקובץ לטווח קצר. השדה הזה יאוכלס רק בקבצים שמכילים תוכן שמאוחסן ב-Drive.

publishAuto

boolean

האם התיקונים הבאים יפורסמו מחדש באופן אוטומטי. השדה הזה מאוכלס רק ואפשר לשנות אותו רק בקבצים של עורכי Docs.

publishedOutsideDomain

boolean

האם הגרסה הזו פורסמה מחוץ לדומיין. השדה הזה מאוכלס רק ואפשר לשנות אותו רק בקבצים של עורכי Docs.

fileSize

string (int64 format)

פלט בלבד. גודל הגרסה בבייטים. השדה הזה יאוכלס רק בקבצים שמכילים תוכן שמאוחסן ב-Drive.

originalFilename

string

פלט בלבד. שם הקובץ המקורי שבו נוצרה הגרסה הקודמת. השדה הזה יאוכלס רק בקבצים שמכילים תוכן שמאוחסן ב-Drive.

lastModifyingUser

object (User)

פלט בלבד. המשתמש האחרון ששינה את הגרסה הזו.

שיטות

delete

מוחקת לצמיתות גרסת קובץ.

get

מקבל גרסה ספציפית.

list

בתיבת הדו-שיח הזו מפורטים הגרסאות הקודמות של הקובץ.

patch

מעדכן גרסה קודמת.

update

מעדכן גרסה קודמת.