מדריך ל-Drive API v2

אם אתם משתמשים ב-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. לפרטים נוספים, ראו מונחים ואופרטורים של שאילתות חיפוש.