אם אתם משתמשים ב-Google Drive API בגרסה 2, רוב התוכן במדריך Google Drive API בגרסה 3 מתייחס גם לגרסה 2. הקטע הזה מכיל את כל המידע הספציפי ל-v2, ושונה מהמידע שמוצג בדפים ספציפיים במדריך גרסה 3. כדי לקבל הקשר מלא, כל קטע משנה מכיל את הקישור לדף המדריך המתאים.
רשימה מלאה של ההבדלים מופיעה בחומר העזר בנושא השוואה בין Drive API v2 ו-v3.
הורדה ופרסום של גרסאות של קבצים
בדף Download & published file files (הורדה ופרסום של גרסאות של קבצים), המידע הבא ספציפי לגרסה 2 ומחליף את הקטעים הבאים שמוצגים בגרסה 3:
הצגת רשימה והורדה של גרסאות קודמות
כשמקבלים רשימה של גרסאות קודמות של קובץ, אפשר להוריד את התוכן של כל גרסה אפשרית על ידי שליחת בקשת GET
מורשית לנכס []downloadUrl
](/drive/api/reference/rest/v2/revisions).
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
ל-methods changes.get
ו-changes.list
יש מספר פרמטרים שספציפיים לתיקיות אחסון שיתופי. רשימת הפרמטרים מופיעה בקטע מעקב אחרי שינויים באחסון שיתופי.
העלאת קבצים
בדף Upload file data, תוכלו לראות שהמידע הזה ספציפי לגרסה 2:
ייבוא לסוגים של Google Docs
כשיוצרים קובץ ב-Google Drive, אפשר להמיר קבצים מסוגים מסוימים למסמך ב-Google Docs, ב-Google Sheets או ב-Google Slides. כוללים את הפרמטרים של השאילתה files.insert
convert
ומגדירים את המאפיין mimeType
של הקובץ (workspace_name). מידע נוסף זמין במאמר העלאת נתוני קבצים.
שיתוף קבצים, תיקיות ונסיעות
הודעה בדף Share קבצים, תיקיות ואחסון, בשדה אחד ב-v3, role
, מציינת תפקידים יעילים למשתמש, לקבוצה או לדומיין. בגרסה 2, השדות role
ו-additionalRoles
של ההרשאה צריכים לשקף את התפקידים האפקטיביים שיש למשתמש, לקבוצה או לדומיין בפריט נתון.
הבדלים בשאילתות חיפוש בגרסה 2
השדה title
של גרסה 2.0 הוא name
בגרסה 3. לדוגמאות, ראו חיפוש קבצים ותיקיות.
השדה createdDate
של גרסה 2.0 הוא createdTime
בגרסה 3. לדוגמאות, ראו חיפוש תיקיות אחסון שיתופי.
השדה modifiedDate
של גרסה 2.0 הוא modifiedTime
בגרסה 3. השדה lastViewedByMeDate
של v2 הוא viewedByMeTime
ב-v3. לפרטים נוספים, ראו מונחים ואופרטורים של שאילתות חיפוש.