במדריך הזה נסביר איך להשתמש במשאב revisions כדי לנהל גרסאות קודמות של קבצים, למשל איך לאחזר גרסה קודמת של קובץ ואיך לפרסם גרסה קודמת של קובץ ב-Google Workspace. בנוסף, Google Drive API מאפשר לכם להוריד גרסאות. בסקירה הכללית על שינויים ועדכונים מוסבר על המינוח שקשור לעדכונים.
כדי לגשת להיסטוריית הגרסאות, למשתמש צריכה להיות הרשאת role ברמה owner, organizer, fileOrganizer או writer.
כדי לציין את השדות שיוחזרו בתגובה, אפשר להגדיר את fields
פרמטר המערכת בכל שיטה של משאב revisions. אם לא מציינים את הפרמטר, השרת מחזיר קבוצת שדות שמוגדרת כברירת מחדל. לדוגמה, השיטה revisions.list מחזירה רק את השדות id, mimeType, kind ו-modifiedTime. כדי להחזיר שדות שונים, אפשר לעיין במאמר החזרת שדות ספציפיים.
ציון הגרסאות לשמירה ממחיקה אוטומטית
Google Drive מוחק באופן אוטומטי גרסאות ישנות יותר שלא מעניינות יותר את המשתמש.
אפשר להגדיר גרסה לא דינמית של קובץ blob כ'שמירה לתמיד', כלומר אי אפשר למחוק את הגרסה באופן אוטומטי. אפשר להגדיר עד 200 גרסאות כ'שמירה לתמיד', והן נכללות במכסת האחסון שלכם. הגרסה הראשית אף פעם לא נמחקת אוטומטית.
אפשר למחוק כל גרסה של קובץ Blob, חוץ מהגרסה העדכנית, שלא סומנה כ'שמירה לתמיד'. בדרך כלל, גרסאות שאפשר למחוק נשמרות למשך 30 יום, אבל אפשר למחוק אותן מוקדם יותר אם לקובץ יש 100 גרסאות שלא סומנו כ'שמירה לתמיד' ומועלית גרסה חדשה.
אפשר להגדיר את השדה הבוליאני keepForever של משאב revisions לערך true כדי לסמן גרסאות שאתם לא רוצים שמערכת Drive תמחק. אחרי שמגדירים גרסה של קובץ Blob ל'שמירה לתמיד', אפשר רק להוריד או למחוק אותה. מידע נוסף זמין במאמרים הורדת שינוי או מחיקת שינוי.
אם אתם משתמשים בגרסה ישנה יותר של Drive API, v2, אתם צריכים להשתמש בשדה pinned של המשאב revisions במקום בשדה keepForever.
איך מקבלים גרסה של קובץ
כדי לקבל את המטא-נתונים או התוכן של תיקון קובץ, משתמשים ב-method get במשאב revisions עם פרמטרי הנתיב fileId ו-revisionId. אם אתם לא יודעים את מזהה הגרסה, אתם יכולים לראות את כל הגרסאות של קובץ באמצעות השיטה list.
השיטה מחזירה את המטא-נתונים של הגרסה כמופע של משאב revisions.
כדי לאשר את הסיכון בהורדת תוכנות זדוניות מוכרות או קבצים פוגעניים אחרים, מגדירים את פרמטר השאילתה acknowledgeAbuse לערך true. השדה הזה רלוונטי רק אם הפרמטר alt=media מוגדר והמשתמש הוא הבעלים של הקובץ או מארגן של האחסון השיתופי שבו הקובץ נמצא.
הצגת הגרסאות הקודמות של קובץ
כדי להציג רשימה של הגרסאות של קובץ, משתמשים ב-method list במשאב revisions עם פרמטר הנתיב fileId. השיטה מחזירה רשימה של גרסאות קודמות של קובץ.
מעבירים את פרמטרים השאילתה הבאים כדי להתאים אישית את המספור של הדפים או לסנן את הגרסאות:
pageSize: מספר הגרסאות המקסימלי שיוחזר בכל דף.
pageToken: טוקן דף שהתקבל מקריאה קודמת של רשימה. צריך לספק את האסימון הזה כדי לאחזר את הדף הבא.
עדכון גרסה של קובץ
כדי לעדכן תיקון בקובץ, משתמשים בשיטה update במשאב revisions עם פרמטרי הנתיב fileId ו-revisionId.
השיטה מחזירה מופע של משאב revisions.
הורדת גרסה
אפשר להוריד רק גרסאות של תוכן בקובץ Blob שסומנו כ'שמירה לתמיד'. אם רוצים להוריד גרסה, צריך קודם להגדיר אותה כ'שמירה לתמיד'. מידע נוסף מופיע במאמר ציון גרסאות לשמירה ממחיקה אוטומטית.
כדי להוריד תוכן של קובץ blob או לייצא תוכן של מסמך ב-Google Workspace, אפשר לעיין במאמר בנושא הורדה וייצוא של קבצים.
מחיקת גרסה של קובץ
כדי למחוק סופית גרסה של קובץ, משתמשים בשיטה delete במשאב revisions עם פרמטרי הנתיב fileId ו-revisionId.
אפשר למחוק רק שינויים בקבצים בינאריים ב-Drive, כמו תמונות, סרטונים וקובצי PDF. אתם יכולים למחוק גרסה של קובץ Blob אם היא מסומנת כ'שמירה לתמיד'. אי אפשר למחוק גרסאות של קבצים אחרים, כמו קובץ Google Docs או Sheets, וגם לא את הגרסה האחרונה שנותרה של הקובץ הבינארי.
פרסום גרסה
כדי לפרסם שינוי ב-Google Docs, ב-Google Sheets וב-Google Slides, צריך להגדיר את המאפיין published של הקובץ במשאב revisions. אי אפשר להגדיר את המאפיין הזה לגרסאות של Google Sites באמצעות Drive API.
שינויים שבוצעו בקובץ לא משתקפים בגרסאות שפורסמו, אלא אם מוגדר המאפיין publishAuto. אם הנכס מוגדר ל-true, גרסאות חדשות יותר של קובץ מתפרסמות אוטומטית, ומחליפות את הגרסאות הקודמות.
ב-Slides וב-Drawings יש תמיכה רק בפרסום מחדש אוטומטי, ונדרש להגדיר את המאפיין publishAuto לערך true. בקבצים של Sites, הערך של publishAuto הוא תמיד false.
אם הקובץ נוצר בדומיין של Google Workspace, המאפיין publishedOutsideDomain מציין אם כל אחד יכול לגשת לגרסה או שהגישה מוגבלת למשתמשים בדומיין. בקבצים של אתרים, המאפיין הזה מציין אם קיימת הרשאה מסוג type=anyone. מידע נוסף מופיע בשדה type במשאב permissions.
הפרסום האוטומטי נשלט גם על ידי תיבת הסימון 'פרסום מחדש של שינויים באופן אוטומטי' בממשק המשתמש של Docs ו-Sheets. מידע נוסף זמין במאמר בנושא הגדרת קבצים כגלויים לכולם ב-Google Docs, Sheets, Slides ו-Forms.