מדריך ל-Drive API v2

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

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

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

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