הבדלים בין האחסון השיתופי לבין ממשק ה-API של 'האחסון שלי'

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

משאב קובץ

השדות הבאים במשאב File מאוכלסים רק לגבי קבצים שנמצאים באחסון שיתופי:

  • hasAugmentedPermissions: האם למשתמשים מסוימים יש גישה ישירה לקובץ.
  • capabilities/canAddFolderFromAnotherDrive: האם המשתמש הנוכחי יכול להוסיף לתיקייה הזו תיקייה מאחסון אחר (אחסון שיתופי אחר או 'האחסון שלי').
  • capabilities/canDeleteChildren: האם המשתמש הנוכחי יכול למחוק תיקיות משנה של התיקייה הזו.
  • capabilities/canMoveChildrenOutOfDrive: האם המשתמש הנוכחי יכול להעביר תיקיות משנה של התיקייה הזו מחוץ לאחסון השיתופי.
  • capabilities/canMoveChildrenWithinDrive: האם המשתמש הנוכחי יכול להעביר תיקיות משנה של התיקייה הזו בתוך האחסון השיתופי.
  • capabilities/canMoveItemWithinDrive: אם המשתמש הנוכחי יכול להעביר את הפריט הזה באחסון השיתופי למקום אחר באחסון השיתופי.
  • capabilities/canReadDrive: אם למשתמש הנוכחי יש גישת קריאה להתקן האחסון המשותף שאליו שייך הקובץ.
  • capabilities/canTrashChildren: האם המשתמש הנוכחי יכול להעביר לאשפה תיקיות משנה של התיקייה הזו.
  • driveId: המזהה של הנסיעה המשותפת שבה נמצא הקובץ.
  • trashingUser: אם הקובץ הועבר לאשפה באופן מפורש, המשתמש שהעביר אותו.
  • trashedTime: השעה שבה הפריט הועבר לאשפה. אם אתם משתמשים בגרסה הקודמת של Drive API v2, השדה הזה נקרא trashedDate.

השדות הבאים לא מאוכלסים לגבי קבצים שנמצאים באחסון שיתופי:

  • permissions: בגלל הגודל הפוטנציאלי של רשימות ACL של אחסון שיתופי, ההרשאות לא מוחזרות כחלק מהקבצים. משתמשים בשיטה permissions.list(), שתומכת בחלוקה לדפים, כדי לרשום את ההרשאות של קובץ באחסון שיתופי או בתיקיית האחסון השיתופי.
  • owners, ownerNames, ownedByMe: הקבצים באחסון השיתופי הם בבעלות של האחסון השיתופי, ולא של משתמשים ספציפיים.
  • folderColorRgb: אי אפשר לצבוע תיקיות בנפרד.
  • shared: כל הפריטים באחסון השיתופי משותפים.
  • writersCanShare: אי אפשר להגביל את השיתוף לפי תפקיד בהתקני אחסון משותפים.

השדות הבאים מוגדרים רק כשהמשתמש קיבל הרשאות גישה לקובץ בפריט:

  • sharedWithMeDate
  • sharingUser

כשמשתמשים בשדות הבאים עם נסיעות משותפות, חשוב לשים לב לדברים הבאים:

  • parents.isRoot: השדה הזה נכון רק לתיקיית השורש של 'האחסון שלי', והוא שגוי לתיקייה ברמה העליונה של האחסון השיתופי.

  • parents: הורה לא מופיע ברשימת ההורים אם המשתמש המבקש לא חבר באחסון השיתופי ואין לו גישה להורה. בנוסף, רשימת ההורים חייבת להכיל פריט אחד בלבד, מלבד התיקייה ברמה העליונה, אם הקובץ נמצא באחסון שיתופי.

  • capabilities/canRemoveChildren: משתמשים ב-capabilities/canDeleteChildren או ב-capabilities/canTrashChildren.

משאב הרשאה

השדה permissionDetails במשאב Permission מאוכלס רק לגבי קבצים שנמצאים באחסון שיתופי. השדה הזה הוא רשימה של הרשאות מקוצרות בקובץ הזה באחסון השיתופי, או הרשאות שעברו בירושה אליו. השדה הזה הוא שדה פלט בלבד, והוא מופיע רק בפריטים באחסון השיתופי. בנוסף,

  • הוגדרו שני תפקידים חדשים, organizer ו-fileOrganizer.
  • השיטה permissions.list() תומכת בחלוקה לדפים.

שינוי משאב

השדות החדשים הבאים זמינים במשאב Change של אחסון שיתופי:

  • changeType: סוג השינוי. הערכים האפשריים הם file ו-drive.
  • driveId: המזהה של האחסון השיתופי שמשויך לשינוי הזה.
  • drive: המצב המעודכן של האחסון השיתופי. הערך הזה מופיע אם הערך של changeType הוא drive והמשתמש עדיין חבר באחסון השיתופי.

יכול להיות שתצטרכו לבצע שינויים נוספים באפליקציות שצריכות לסנכרן תוכן עם תיקיות אחסון שיתופי או לעקוב אחרי פעילות. לפרטים נוספים, ראו מעקב אחרי שינויים של משתמשים ותיקיות אחסון שיתופי.