יישום תמיכה באחסון שיתופי

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

כדי להתחיל, צריך לכלול את פרמטר השאילתה supportsAllDrives=true בבקשות כשהאפליקציה מבצעת את הפעולות הבאות:

Drive API v3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

Drive API v2

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

הפרמטר supportsAllDrives=true מודיע ל-Google Drive שהאפליקציה שלכם מיועדת לטיפול בקבצים בתיקיות אחסון שיתופי.

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

חיפוש תוכן באחסון שיתופי

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

השיטה list מכילה את פרמטרים השאילתה הבאים שספציפיים לאחסון השיתופי:

  • ‫driveId: המזהה של האחסון השיתופי שרוצים לחפש בו.

  • ‫corpora: גופי הפריטים (קבצים או מסמכים) שהשאילתה חלה עליהם. הגופים הנתמכים הם user,‏ domain,‏ drive ו-allDrives. עדיפות ל-user או ל-drive על פני allDrives לצורך יעילות. כברירת מחדל, הערך של corpora הוא user.

  • ‫includeItemsFromAllDrives: האם לכלול בתוצאות פריטים מ'האחסון שלי' ומאחסון שיתופי. אם המאפיין לא קיים או מוגדר כ-False, לא יוחזרו פריטים באחסון השיתופי.

  • ‫supportsAllDrives: האם האפליקציה ששולחת את הבקשה תומכת גם ב'האחסון שלי' וגם באחסון השיתופי. אם הערך הוא False, פריטים באחסון שיתופי לא נכללים בתגובה.

מצבי השאילתה הבאים ספציפיים לאחסון שיתופי:

includeItemsFromAllDrives corpora תיאור השאילתה
true user שאילתות לגבי קבצים שהמשתמש ניגש אליהם, כולל קבצים באחסון השיתופי ובתיקיית 'האחסון שלי'.
true domain שאילתות לגבי קבצים ששותפו עם הדומיין, כולל קבצים בתיקיות אחסון שיתופי ובתיקיית 'האחסון שלי'.
true drive השאילתה מחפשת את כל הפריטים בתיקיית האחסון השיתופי שצוינה. צריך לציין את driveId בבקשה.
true allDrives שאילתת קבצים שהמשתמש ניגש אליהם וכל תיקיות האחסון השיתופי שהוא חבר בהן. שימו לב: יכול להיות שהתשובה תכלול את הסימן incompleteSearch:true, שמציין שחלק מהמאגרים לא נבדקו במסגרת הבקשה הזו.

מעקב אחר שינויים באחסון שיתופי

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

השיטה list מכילה את פרמטרים השאילתה הבאים שספציפיים לאחסון השיתופי:

  • ‫driveId: האחסון השיתופי שממנו מוחזרים השינויים. אם מצוין, מזהי השינויים מתייחסים לשינויים בפריטים באחסון השיתופי, ומספקים את המצב הנוכחי של קובץ. כדי להתייחס לשינוי ספציפי באחסון השיתופי, צריך להשתמש במזהה של האחסון השיתופי ובמזהה של השינוי.

  • ‫includeItemsFromAllDrives: האם לכלול ברשימת השינויים קבצים או שינויים בתיקיות אחסון שיתופי.

  • ‫supportsAllDrives: האם האפליקציה ששלחה את הבקשה תומכת באחסון שיתופי. אם הערך הוא false, לא מוחזרים פריטים באחסון שיתופי, כולל תיקיות באחסון שיתופי וקבצים בתוך אחסון שיתופי.

מצבי השאילתה הבאים ספציפיים לאחסון שיתופי:

includeItemsFromAllDrives driveId תיאור השאילתה
true לא השינויים משקפים שינויים בקבצים בתוך תיקיות אחסון שיתופי או מחוצה להן שהמשתמש ניגש אליהם, וגם שינויים בתיקיות אחסון שיתופי שהמשתמש חבר בהן.
true כן השינויים משקפים שינויים באחסון השיתופי הספציפי שצוין ובפריטים בתוך האחסון השיתופי הזה.

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

הפעלת תמיכה באחסון שיתופי בממשק המשתמש של Drive

כדי לגשת לתוכן בתיקיית אחסון שיתופי באמצעות ממשק המשתמש של Drive, צריך לוודא שסימנתם את התיבה Shared drives support (תמיכה בתיקיות אחסון שיתופי) בכרטיסייה Drive UI integration (שילוב ממשק המשתמש של Drive) של Google Drive API במסוף Google Cloud. מידע נוסף זמין במאמר הגדרת שילוב של ממשק משתמש של Drive.

שימוש בכלי לבחירת קבצים של Google עם תיקיות אחסון שיתופי

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