הבדלים בין האחסון השיתופי לבין ממשק ה-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 – השדה הזה רלוונטי רק לתיקיית הבסיס של 'האחסון שלי'. השדה הזה מוגדר כ-False אם מדובר בתיקייה ברמה העליונה של האחסון השיתופי.
  • parents – הורה לא מופיע ברשימת ההורים אם המשתמש שביקש את הבקשה אינו חבר באחסון השיתופי ואין לו גישה להורה. בנוסף, למעט התיקייה ברמה העליונה, רשימת ההורים חייבת להכיל פריט אחד בלבד אם הקובץ נמצא בתוך אחסון שיתופי.

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

משאב Permissions

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

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

משאב Changes

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

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

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