מדריך ל-Drive API v2

אם אתם משתמשים ב-Google Drive API בגרסה 2, רוב התוכן ב-Google Drive API מדריך 3 מתייחס גם לגרסה 2. הקטע הזה מכיל את כל המידע שספציפי לגרסה 2, והוא שונה שמוצגת בדפים ספציפיים במדריך גרסה 3. כדי לקבל הקשר מלא, כל אחד מסעיפי המשנה מכילה את הקישור לדף המדריך המתאים.

רשימה מלאה של ההבדלים זמינה ב-Drive API v2 & השוואה לגרסה 3 .

הורדה ו- לפרסם גרסאות של קבצים

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

שיתוף קבצים, תיקיות נסיעות

הודעה לגבי שיתוף קבצים, תיקיות נסיעות ב-v3, שדה אחד בלבד, role, מציין את התפקידים האפקטיביים עבור משתמש, קבוצה, או דומיין. בגרסה 2, נדרשים גם השדה role וגם השדה additionalRoles של משקפת את התפקידים האפקטיביים שיש למשתמש, לקבוצה או לדומיין של הפריט הנתון.

הבדלים בשאילתות חיפוש בגרסה 2

השדה title של גרסה 2.0 הוא name בגרסה 3. אפשר לראות דוגמאות בקטע חיפוש קבצים תיקיות.

השדה createdDate של גרסה 2.0 הוא createdTime בגרסה 3. אפשר לראות דוגמאות בקטע חיפוש תיקיות אחסון שיתופי.

השדה modifiedDate של גרסה 2.0 הוא modifiedTime בגרסה 3. גרסה 2 של lastViewedByMeDate השדה הוא viewedByMeTime בגרסה 3. לפרטים נוספים, אפשר לעיין בקטע מונחי חיפוש ומונחי חיפוש אופרטורים.