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

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

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