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

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

המשאב Files

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

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

  • trashedTime — השעה שבה הפריט הועבר לאשפה.

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

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

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

  • sharedWithMeDate
  • sharingUser

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

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

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

  • capabilities/canRemoveChildren – אפשר להשתמש ב-capabilities/canDeleteChildren או ב-capabilities/canTrashChildren.

המשאב Permissions

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

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

המשאב Changes

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

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

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