אם אתם משתמשים בגרסה 2 של Google Drive API, רוב התוכן בגרסה 3 של המדריך ל-Google Drive API מתייחס גם הוא לגרסה 2. המקטע הזה מכיל את כל המידע הספציפי ל-v2, ושונה ממה שמוצג בדפים ספציפיים במדריך של v3. כדי לקבל את ההקשר המלא, כל קטע משנה מכיל את הקישור לדף המדריך המתאים.
כאן תוכלו למצוא את רשימת ההבדלים המלאה ב-Drive API v2 ו-v3.
הורדה ופרסום של גרסאות קודמות של קבצים
בדף Download & publish file users, הפרטים הבאים רלוונטיים ספציפית לגרסה 2 ומחליפים את הקטעים האלה בגרסה 3:
הצגה והורדה של גרסאות קודמות
אחרי שמקבלים רשימה של הגרסאות הקודמות של הקובץ, אפשר להוריד את התוכן של כל גרסה על ידי שליחת בקשת GET
מורשית לנכס
[]downloadUrl
](/drive/api/reference/rest/v2/revisions) שלו.
מערכת Google Drive יוצרת את כתובת ה-URL לטווח קצר הזו כשמבקשים את התיקון.
אין להסתמך על התכונה הזו לשימוש מאוחר יותר.
אפשר גם לייצא את הגרסה הקודמת באחד מהפורמטים הנתמכים על ידי בדיקת
המאפיין 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. צריך לכלול את הפרמטרים של השאילתה 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. מידע נוסף זמין במאמר מונחים ואופרטורים של שאילתות חיפוש.