מדריך ל-Drive API v2

אם אתם משתמשים ב-Google Drive API גרסה 2, רוב התוכן במדריך Google Drive API גרסה 3 רלוונטי גם לגרסה 2. בקטע הזה מופיע כל המידע שרלוונטי לגרסה 2, ושונה ממה שמופיע בדפים ספציפיים במדריך לגרסה 3. כדי לקבל הקשר מלא, בכל חלק משני מופיע קישור לדף המדריך המתאים.

רשימה מלאה של ההבדלים מופיעה בחומר העזר בנושא השוואה בין Drive API גרסה 2 לגרסה 3.

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

בדף הורדה ופרסום של גרסאות קודמות של קובץ, המידע הבא ספציפי לגרסה 2 ומחליף את הקטעים האלה שמוצגים בגרסה 3:

הצגה והורדה של גרסאות נפרדות

אחרי שמקבלים רשימה של שינויים בקובץ, אפשר להוריד את התוכן של כל שינוי על ידי שליחת בקשת GET מורשית למאפיין [downloadUrl](/workspace/drive/api/reference/rest/v2/revisions) שלו. מערכת Google Drive יוצרת את כתובת ה-URL הזו לזמן קצר כשמבקשים את הגרסה. אל תסתמכו על כך שתוכלו להשתמש בו מאוחר יותר.

אפשר גם לייצא את הגרסה בפורמט נתמך על ידי סימון המאפיין exportLinks.

מאפייני קובץ מותאמים אישית

בנוסף למידע שמופיע בדף הוספת מאפיינים מותאמים אישית לקובץ, המידע הבא רלוונטי רק לגרסה 2:

הגישה לנכסים מתבצעת באמצעות המשאב properties.

זוהי הדוגמה למבנה של מאפיין אופייני שאפשר להשתמש בו כדי לאחסן את מזהה מסד הנתונים של קובץ ב-Drive בקובץ.

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

מידע נוסף על מגבלות מופיע במאמרי עזרה properties.

הפעלת תמיכה באחסון שיתופי

בנוסף למידע שבדף Implement shared drive support, צריך להחליף את השדה הנוסף הזה trashedDate בגרסה 2.

בקטע Implement shared drive support, כשעובדים עם תוכן בתיקיות אחסון שיתופי, צריך להשתמש בשיטות הבאות: supportsAllDrives=true

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

לשיטות changes.get ו-changes.list יש כמה פרמטרים שספציפיים לכוננים משותפים. רשימת הפרמטרים מופיעה בקטע מעקב אחרי שינויים ב-Drive משותף.

העלאת קבצים

בדף העלאת נתונים מקובץ, שימו לב שהמידע הזה ספציפי לגרסה 2:

ייבוא לסוגים של Google Docs

כשיוצרים קובץ ב-Google Drive, אפשר להמיר סוגים מסוימים של קבצים למסמך ב-Google Docs, ב-Google Sheets או ב-Google Slides. כוללים את פרמטרים השאילתה files.insert convert ומגדירים את המאפיין (workspace_name) mimeType של הקובץ. מידע נוסף זמין במאמר בנושא העלאת נתוני קבצים.

שיתוף קבצים, תיקיות ותיקיות אחסון שיתופי

בגרסה 3, בדף שיתוף קבצים, תיקיות וכוננים, יש רק שדה אחד, role, שמציין את התפקידים בפועל של משתמש, קבוצה או דומיין. בגרסה 2, שני השדות role ו-additionalRoles של הרשאה משקפים את התפקידים בפועל שיש למשתמש, לקבוצה או לדומיין עבור פריט נתון.

הבדלים בשאילתות חיפוש בגרסה 2

השדה title בגרסה 2 הוא name בגרסה 3. דוגמאות מופיעות במאמר חיפוש קבצים ותיקיות.

השדה createdDate בגרסה 2 הוא createdTime בגרסה 3. דוגמאות מופיעות במאמר חיפוש תיקיות ב-Drive המשותף.

השדה modifiedDate בגרסה 2 הוא modifiedTime בגרסה 3. השדה lastViewedByMeDate בגרסה 2 הוא viewedByMeTime בגרסה 3. פרטים נוספים זמינים במאמר בנושא מונחים ואופרטורים של שאילתות חיפוש.