REST Resource: revisions

משאב: Revision

גרסה של קובץ.

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

ייצוג ב-JSON
{
  "exportLinks": {
    string: string,
    ...
  },
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "etag": 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, לא כולל קבצים של עורכי Google Docs. אפשר גם להצמיד גרסאות כשיוצרים אותן באמצעות drive.files.insert/update/copy באמצעות פרמטר השאילתה pinned. גרסאות מוצמדות מאוחסנות ללא הגבלת זמן, תוך שימוש במכסת אחסון נוספת, עד למקסימום של 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)

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

Methods

delete

מחיקה סופית של גרסת קובץ.

get

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

list

מציג את הגרסאות הקודמות של קובץ.

patch

עדכון של גרסה.

update

עדכון של גרסה.