Google Drive API מספק את המשאב גרסאות כדי לאפשר הורדה ופרסום של גרסאות של קבצים. מידע נוסף על מונחי גרסאות זמין במאמר סקירה כללית של שינויים ותיקונים.
ציון גרסאות קודמות לשמירה ממחיקה אוטומטית
מערכת 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
קובצי אתרים. המאפיין הזה מציין אם קיימת הרשאת type=anyone
.
גרסאות קודמות שפורסמו לא משקפות שינויים שבוצעו בקובץ, אלא אם מוגדר המאפיין publishAuto
. אם המאפיין מוגדר כ-True, גרסאות חדשות יותר של הקובץ יפורסמו באופן אוטומטי ויחליפו את הגרסאות הקודמות. אפשר לשלוט בהתנהגות הזו גם באמצעות האפשרות 'פרסום מחדש באופן אוטומטי לאחר עריכת שינויים' תיבת סימון בממשק המשתמש של Drive. בקובצי Google Sites, הערך של publishAuto
הוא תמיד false
.