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

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

כדי להתחיל, צריך לכלול את פרמטר השאילתה 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 לצורך יעילות. כברירת מחדל, המאגר מוגדר כ-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.