מדריך ל-Drive API v2

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