הורדה ופרסום של גרסאות קודמות של קובץ

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.