מדריך ל-Drive API v2

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

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

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

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

הצגת רשימה של גרסאות קודמות והורדה שלהן

אחרי שמקבלים רשימה של הגרסאות של קובץ, אפשר להוריד את התוכן של כל גרסה על ידי שליחת בקשת GET מורשית לנכס downloadUrl שלו. כתובת ה-URL הזמנית הזו נוצרת ב-Google Drive כששולחים בקשה לגרסה הקודמת. אין להסתמך על התכונה הזו לשימוש מאוחר יותר.

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

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

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

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

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

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

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

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

בנוסף למידע שמופיע בדף הטמעת תמיכה בנסיעה משותפת, צריך להחליף את השדה הנוסף הזה trashedDate בגרסה 2.

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

העלאת קבצים

בדף Upload file data, שימו לב שהמידע הזה ספציפי לגרסה 2:

סוגי הקבצים שאפשר לייבא ל-Google Docs

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

שיתוף קבצים, תיקיות ודיסקים

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

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

השדה title ב-v2 הוא name ב-v3. דוגמאות מפורטות מופיעות בקטע חיפוש קבצים ותיקיות.

השדה createdDate ב-v2 הוא createdTime ב-v3. לדוגמאות, ראו חיפוש של נסיעות משותפות.

השדה modifiedDate ב-v2 הוא modifiedTime ב-v3. השדה lastViewedByMeDate ב-v2 הוא viewedByMeTime ב-v3. פרטים נוספים זמינים במאמר מונחים ואופרטורים של שאילתות חיפוש.