מדריך ל-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.

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

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

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

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

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