Google Drive API מספק את המשאב revisions כדי שתוכלו להוריד ולפרסם גרסאות של קבצים. לפרטים נוספים על המינוח שקשור לגרסאות, אפשר לעיין במאמר סקירה כללית על שינויים וגרסאות.
במדריך הזה מוסבר איך לנהל גרסאות של קבצים באמצעות Google Drive API.
ציון גרסאות לשמירה ממחיקה אוטומטית
Google Drive מוחק באופן אוטומטי גרסאות ישנות יותר שכבר לא מעניינות את המשתמש.
אפשר להגדיר גרסה לא דינמית של קובץ blob כ'שמירה לתמיד', כלומר אי אפשר למחוק את הגרסה באופן אוטומטי. אפשר להגדיר עד 200 גרסאות כ'שמירה לתמיד', והן נכללות במכסת האחסון. הגרסה הראשית אף פעם לא נמחקת אוטומטית.
אפשר למחוק כל גרסה של קובץ blob, חוץ מהגרסה העדכנית, שלא סומנה כ'שמירה לתמיד'. בדרך כלל, גרסאות שאפשר למחוק נשמרות למשך 30 יום, אבל אפשר למחוק אותן מוקדם יותר אם לקובץ יש 100 גרסאות שלא סומנו כ'שמירה לתמיד' ומועלית גרסה חדשה.
אפשר להגדיר את השדה הבוליאני keepForever של משאב revisions לערך true כדי לסמן גרסאות שאתם לא רוצים שמערכת Drive תמחק. אחרי שמגדירים גרסה של קובץ Blob ל'שמירה לתמיד', אפשר רק להוריד או למחוק אותה. מידע נוסף זמין במאמרים הורדת שינוי או מחיקת שינוי.
הורדת גרסה
אפשר להוריד רק גרסאות של תוכן בקובץ Blob שסומנו כ'שמירה לתמיד'. אם רוצים להוריד גרסה, צריך קודם להגדיר אותה כ'שמירה לתמיד'. מידע נוסף זמין במאמר ציון גרסאות שרוצים לשמור כדי שלא יימחקו אוטומטית.
כדי להוריד תוכן של קובץ blob או לייצא תוכן של מסמך ב-Google Workspace, אפשר לעיין במאמר בנושא הורדה וייצוא של קבצים.
מחיקת גרסה
אפשר להתקשר לשיטת revisions.delete כדי למחוק באופן סופי גרסה של קובץ blob, גם אם היא מסומנת כ'שמירה לתמיד'.
אם אתם משתמשים בגרסה ישנה יותר של Drive API, v2, אתם צריכים להשתמש בשדה pinned של המשאב revisions.
פרסום גרסה
כדי לפרסם שינוי ב-Google Docs, ב-Google Sheets וב-Google Slides, צריך להגדיר את המאפיין published של הקובץ במשאב revisions. אי אפשר להגדיר את המאפיין הזה לגרסאות של Google Sites באמצעות Drive API.
Google Slides ו-Google Drawings לא תומכים בפרסום של גרסאות ספציפיות. המערכת תומכת רק בפרסום מחדש אוטומטי של הגרסה האחרונה. כדי לפרסם מצגות ב-Slides וציורים ב-Drawings, צריך להגדיר את publishAuto ל-true.
אם הקובץ נוצר בדומיין של Google Workspace, המאפיין publishedOutsideDomain מציין אם כל אחד יכול לגשת לגרסה או שהגישה מוגבלת למשתמשים בדומיין. בקבצים של אתרים, המאפיין הזה מציין אם קיימת הרשאה מסוג type=anyone. מידע נוסף מופיע בשדה type במשאב permissions.
שינויים שבוצעו בקובץ לא משתקפים בגרסאות שפורסמו, אלא אם מוגדר המאפיין publishAuto. אם הנכס מוגדר ל-true, גרסאות חדשות יותר של קובץ מתפרסמות אוטומטית ומחליפות את הגרסאות הקודמות.
ב-Slides וב-Drawings יש תמיכה רק בפרסום מחדש אוטומטי, ונדרש להגדיר את המאפיין publishAuto לערך true. בקבצים של Sites, הערך של publishAuto הוא תמיד false.
הפרסום האוטומטי נשלט גם על ידי תיבת הסימון 'פרסום מחדש של שינויים באופן אוטומטי' בממשק המשתמש של Docs ו-Sheets. מידע נוסף זמין במאמר בנושא הגדרת קבצים כגלויים לכולם ב-Google Docs, Sheets, Slides ו-Forms.