מדריך ל-Drive API v2

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

רשימה מלאה של ההבדלים מופיעה במאמר השוואה בין Drive API v2 ל-v3.

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

בדף הורדה ופרסום של גרסאות קודמות של קובץ, המידע הבא ספציפי לגרסה 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.

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

בנוסף למידע שבדף הטמעה של תמיכה בתיקיות משותפות, צריך להחליף את השדה הנוסף הזה 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. דוגמאות אפשר למצוא במאמר חיפוש תיקיות משותפות.

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