ממשק ה-API של Google Drive מספק את המשאב גרסאות כדי לאפשר לך להוריד ולפרסם גרסאות קודמות של קבצים. למידע נוסף על טרמינולוגיה של גרסאות קודמות, אפשר לעיין במאמר סקירה כללית על שינויים ותיקונים.
ציון גרסאות קודמות לשמירה מהמחיקה האוטומטית
Google Drive מוחק באופן אוטומטי גרסאות קודמות שכבר לא מעניינות את המשתמש. כדי למנוע את זה, אפשר להגדיר את הסימון הבוליאני keepRevisionForever ל-true כדי לסמן גרסאות קודמות שאתם לא רוצים ש-Drive תמחק לצמיתות.
הורדת גרסה קודמת
ניתן להשתמש בערך של השדה headRevisionId מהמשאב קבצים כדי להוריד את הגרסה האחרונה.
פעולה זו מאחזרת את הגרסה התואמת את המטא נתונים של הקובץ שאוחזרת קודם לכן. כדי להוריד את הנתונים של כל הגרסאות הקודמות של הקובץ שעדיין מאוחסנות בענן, ניתן לבצע קריאה ל-revisions.list, שמקבל את כל הגרסאות הקודמות.
כדי להוריד את תוכן הגרסה הקודמת, צריך להפעיל את השיטה revisions.get עם הפרמטר alt=media. לא ניתן להוריד גרסאות קודמות של Google Docs , Sheets ו-Slides.
גרסאות קודמות של Google Docs , Google Drawings ו-Slides מגדילים באופן אוטומטי את מספרי הגרסאות. עם זאת, בסדרת המספרים עשויים להיות פערים אם הגרסאות נמחקות, לכן אין להסתמך על מספרים רציפים בעת אחזור תיקונים.
פרסום גרסה קודמת
כדי לפרסם גרסה של Google Docs , Sheets ו-Slides, צריך להגדיר את המאפיין published של הקובץ הזה בנכס גרסאות קודמות. לא ניתן להגדיר את הנכס הזה לגרסאות קודמות של Google Sites דרך Drive API.
אם הקובץ נוצר בדומיין Google Workspace ,
המאפיין publishedOutsideDomain מציין אם הגרסה הזו נגישה לכולם או אם היא מוגבלת למשתמשים בדומיין. בקבצים ב-Google Sites, המאפיין הזה מציין אם קיימת הרשאת type=anyone.
גרסאות קודמות שפורסמו לא משקפות שינויים שבוצעו בקובץ, אלא אם הוגדר המאפיין publishAuto. אם מאפיין זה מוגדר כ-True, גרסאות קודמות יותר של הקובץ יפורסמו באופן אוטומטי ויחליפו את הגרסאות הקודמות. ההתנהגות הזו נקבעת גם על ידי תיבת הסימון 'פרסום מחדש באופן אוטומטי לאחר ביצוע שינויים' בממשק המשתמש של Drive. לקבצים ב-Google Sites, הערך publishAuto הוא תמיד false.