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

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