REST Resource: revisions

משאב: גרסה

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

ל-methods מסוימות של משאבים (כמו 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

פלט בלבד. סיכום ביקורת (checksum) 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

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