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

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

במדריך הזה מפורטים ההבדלים בין ממשקי ה-API של משאבי files ו-changes באחסון שיתופי.

משאב קובץ

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

  • ‫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: הערך של השדה הזה הוא true רק עבור תיקיית הבסיס של 'האחסון שלי'. הערך הוא false עבור תיקיית הרמה העליונה של האחסון השיתופי.

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

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

שינוי המשאב

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

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

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