REST Resource: revisions

משאב: גרסה

המטא-נתונים של גרסה של קובץ.

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

ייצוג ב-JSON 
{
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "exportLinks": {
    string: string,
    ...
  },
  "keepForever": boolean,
  "md5Checksum": string,
  "modifiedTime": string,
  "publishAuto": boolean,
  "publishedOutsideDomain": boolean,
  "publishedLink": string,
  "size": string,
  "originalFilename": string,
  "lastModifyingUser": {
    object (User)
  }
}
שדות
id

string

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

string

פלט בלבד. סוג ה-MIME של הגרסה.
kind

string

פלט בלבד. מזהה את סוג המשאב. ערך: המחרוזת הקבועה "drive#revision".
published

boolean

האם הגרסה הזו פורסמה. האפשרות הזו רלוונטית רק לקבצים של Docs Editors.
keepForever

boolean

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

השדה הזה רלוונטי רק לקבצים עם תוכן בינארי ב-Drive.
md5Checksum

string

פלט בלבד. סיכום הביקורת (checksum) מסוג MD5 של תוכן הגרסה. האפשרות הזו רלוונטית רק לקבצים עם תוכן בינארי ב-Drive.
modifiedTime

string

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

boolean

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

boolean

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

string (int64 format)

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

string

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

object (User)

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

Methods

delete

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

get

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

list

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

update

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